Countries, States, Cities

country-cities

$3

npm i country-cities

$3

* Get Countries

import { countries } from "country-cities"




All of Countries

``js
countries.all()
`


`js
[
{
"isoCode": "US",
"name": "United State",
"phonecode": "1",
"flag": "🇺🇸",
"currency": "USD",
"latitude": "38.00000000",
"longitude": "-97.00000000",
"timezones": [
{
"zoneName": "America/Adak",
"gmtOffset": -36000,
"gmtOffsetName": "UTC-10:00",
"abbreviation": "HST",
"tzName": "Hawaii–Aleutian Standard Time"
},
{
"zoneName": "America/Kentucky/Louisville",
"gmtOffset": -18000,
"gmtOffsetName": "UTC-05:00",
"abbreviation": "EST",
"tzName": "Eastern Standard Time (North America)"
},
...
]
},
{
"isoCode": "FR",
"name": "France",
"phonecode": "33",
"flag": "🇫🇷",
"currency": "EUR",
"latitude": "46.00000000",
"longitude": "2.00000000",
"timezones": [
{
"zoneName": "Europe/Paris",
"gmtOffset": 3600,
"gmtOffsetName": "UTC+01:00",
"abbreviation": "CET",
"tzName": "Central European Time"
}
]
}
]
`




Get country by its code

`js
countries.getByCode("US")
`


`js
{
"isoCode": "US",
"name": "United State",
"phonecode": "1",
"flag": "🇺🇸",
"currency": "USD",
"latitude": "38.00000000",
"longitude": "-97.00000000",
"timezones": [
{
"zoneName": "America/Adak",
"gmtOffset": -36000,
"gmtOffsetName": "UTC-10:00",
"abbreviation": "HST",
"tzName": "Hawaii–Aleutian Standard Time"
},
{
"zoneName": "America/Kentucky/Louisville",
"gmtOffset": -18000,
"gmtOffsetName": "UTC-05:00",
"abbreviation": "EST",
"tzName": "Eastern Standard Time (North America)"
}, ...
]
}
`



**




* Get States

import { states } from "country-cities"




All of States in the world

`js
states.all()
`


`js
[
{
countryCode: "US",
isoCode: "VA",
latitude: "37.43157340",
longitude: "-78.65689420",
name: "Virginia"
},
{
countryCode: "US",
isoCode: "IL",
latitude: "40.63312490",
longitude: "-89.39852830",
name: "Illinois"
},
...
]
`




Get States by Country

`js
states.getByCountry("US")
`


`js
[
{
countryCode: "US",
isoCode: "VA",
latitude: "37.43157340",
longitude: "-78.65689420",
name: "Virginia"
},
{
countryCode: "US",
isoCode: "IL",
latitude: "40.63312490",
longitude: "-89.39852830",
name: "Illinois"
},
...
]
`




Get State by Code

`js
states.getByCode("VA", "US")
`
Important: The country code should be entered second parameter

`js

{
countryCode: "US",
isoCode: "VA",
latitude: "37.43157340",
longitude: "-78.65689420",
name: "Virginia"
},
`



**




* Get Cities

import { cities } from "country-cities"




All of Cities

cities.all()


`js
[
{
countryCode: "AU",
latitude: "-31.12756000",
longitude: "150.90711000",
name: "Hillvue",
stateCode: "NSW",
},
{
countryCode: "AU",
latitude: "-33.91878000",
longitude: "150.86314000",
name: "Hinchinbrook",
stateCode: "NSW",
},
...
]
`




Get Cities by Country

`js
cities.getByCountry("AU")
`


`js
[
{
countryCode: "AU",
latitude: "-31.12756000",
longitude: "150.90711000",
name: "Hillvue",
stateCode: "NSW",
},
{
countryCode: "AU",
latitude: "-33.91878000",
longitude: "150.86314000",
name: "Hinchinbrook",
stateCode: "NSW",
},
...
]
`




Get Cities by State and Country

`js
cities.getByState("NSW", "AU")
`
Important: The country code should be entered second parameter

`js
[
{
countryCode: "AU",
latitude: "-31.12756000",
longitude: "150.90711000",
name: "Hillvue",
stateCode: "NSW",
},
{
countryCode: "AU",
latitude: "-33.91878000",
longitude: "150.86314000",
name: "Hinchinbrook",
stateCode: "NSW",
},
...
]
``