Countries, States, Cities Library
npm install country-citiescountry-cities
npm i country-cities
Countries
import { countries } from "country-cities"
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",
},
...
]
``