javascript-bits / countries-with-cities-select

All countries with cities select dropdown

countries-with-cities-select

Retrieve all countries with cities

Table of Contents

• Get countries
• Get countries with details
• Get cities

Features

• Get names, codes and cities of all countries
• Filter cities by country name, country code, continent name

Installing

npm install countries-with-cities-select

OR

yarn add countries-with-cities-select

Once the package is installed you use the require/import approach

const countriesWithCities = require('countries-with-cities-select');

OR

import countriesWithCities from 'countries-with-cities-select'

Or with TypeScript

import * as countriesWithCities from 'countries-with-cities-select'

create a .d.ts file and add

declare module 'countries-with-cities-select'

#Get countries

This will list all countries.

const countriesWithCities = require('countries-with-cities-select');
// To get all countries
countriesWithCities.getCountries();

#Get countries with details

This will retrieve information about countries with code, continent etc. Filter by country name, country code or continent

const countriesWithCities = require('countries-with-cities-select');

countriesWithCities.getCountriesWithDetails();

// To get the countries with code, name or continent name
countriesWithCities.getCountriesWithDetails("kenya");
// use exact code to filter country with code
countriesWithCities.getCountriesWithDetails("KE");
countriesWithCities.getCountriesWithDetails("africa");

#Get cities

This will retrieve information about cities. Filter with country name, country code or continent Empty filter will return no cities

const countriesWithCities = require('countries-with-cities-select');

// To get all cities in a country
countriesWithCities.getCities('kenya'); 

// To get all cities in a continent
countriesWithCities.getCities('africa');

// To get all cities in a country with code
countriesWithCities.getCities('ke');

// To getcity with name
countriesWithCities.getCities('nairobi');

License

MIT

Happy coding, Star before Fork 😊💪💯

countries-with-cities-select's Issues

Add Contributing.md Document

Add a contribution document to allow new people contribute easily

Addition of Currency Codes

Country code currency

========================================

For example the following data https://api.apilayer.com/exchangerates_data/latest

{
  "base": "USD",
  "date": "2023-05-17",
  "rates": {
    "AED": 3.672102,
    "AFN": 87.497294,
    "ALL": 102.302218,
    "AMD": 386.310004,
    "ANG": 1.801776,
    "AOA": 526.495828,
	}
}