Country-City-Multilanguage

A lightweight and efficient package for accessing country and city data. Easily integrate country and city information into your JavaScript or TypeScript applications.

Features

- Retrieve country and city lists
- Get country or city by label
- Optimized, minified JSON data for fast lookups
- TypeScript types included
- Simple, synchronous API

Installation

``bash
npm install country-city-multilanguage
`

Usage

$3

`typescript
import { getCountries, getCountryByLabel } from 'country-city-multilanguage';
import { getCities, getCitiesByCountry, getCityByLabel } from 'country-city-multilanguage';
`

$3

`typescript
const countries = getCountries();
console.log(countries);
/*
[
{label: "Afghanistan", label_ar: "أفغانستان", label_fr: "Afghanistan"},
{label: "Morocco", label_ar: "المغرب", label_fr:" Maroc"},
// ...
]
*/
`

$3

`typescript
const country = getCountryByLabel('Morocco');
console.log(country);
/*
{label: "Morocco", label_ar: "المغرب", label_fr:" Maroc"}
*/
`

$3

`typescript
const allCities = getCities();
console.log(allCities);
/*
[
{ country: 'Morocco', cities: [{ "label": "Kenitra", "label_ar": "القنيطرة", "label_fr": "Kenitra" }, ...] },
// ...
]
*/
`

$3

`typescript
const citiesInFrance = getCitiesByCountry('Morocco');
console.log(citiesInFrance);
/*
[
{ "label": "Kenitra", "label_ar": "القنيطرة", "label_fr": "Kenitra" },
{ "label": "Mohammedia", "label_ar": "المحمدية", "label_fr": "Mohammedia" },
// ...
]
*/
`

$3

`typescript
const city = getCityByLabel('Morocco', 'Kenitra');
console.log(city);
/*
{ "label": "Kenitra", "label_ar": "القنيطرة", "label_fr": "Kenitra" }
*/
``

API

$3

Returns an array of country objects.

$3

Returns a country object matching the given label.

$3

Returns an array of all city objects grouped by country.

$3

Returns an array of city objects for the given country label.

$3

Returns a city object matching the given label within the specified country.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

MIT License. See LICENSE for details.