@ac-dev/cities-service 中文文档教程

发布于 3年前 浏览 19 项目主页 更新于 3年前

# Countries Service [![NPM](https://nodei.co/npm/@ac-dev/cities-service.png?compact=true)](https://nodei.co/npm/@ac-dev/cities-service/)
[![](https://img.shields.io/npm/dt/@ac-dev/cities-service.svg?style=flat-square)](https://www.npmjs.com/package/@ac-dev/countries-service)

Table of contents

  1. Mission
  2. Getting started
  1. Usage
  2. Contributors
  3. Need help
  4. Licence
  5. Sponsor

Mission

  • I've never found any complete library to get all world countries, states, and cities. I want to develop the best one. Of course, contributors are welcome!!
  • I took this data as a starting point.
  • This package is a part of countries-states-cities-service

Getting started

要开始使用这个库,您需要安装它并将其添加到您的项目中。

Installation

城市服务作为 npm 包提供。

# npm
npm install @ac-dev/cities-service

# yarn
yarn add @ac-dev/cities-service

Import

导入单个命名导入如下:

import { Cities } from '@ac-dev/cities-service'

Usage

下面的代码片段显示了如何在一些常见用例中实施 cities-service

  • Get all cities.
const cities = Cities.getCities()
  • Get all cities by asc sort.
const cities = Cities.getCities({
  sort: {
    mode: 'asc',
  },
})
  • Get all cities by desc sort.
const cities = Cities.getCities({
  sort: {
    mode: 'desc',
  },
})
  • Get all cities by alphabetical sort.
const cities = Cities.getCities({
  sort: {
    mode: 'alphabetical',
    key: 'name',
  },
})
  • Get Italian cities.
const cities = Cities.getCities({
  filters: {
    country_code: 'IT',
  },
})
  • Get Italian and French cities.
const cities = Cities.getCities({
  filters: {
    country_code: ['IT', 'FR'],
  },
})
  • Get Italian Ligurian cities.
const cities = Cities.getCities({
  filters: {
    country_code: 'IT',
    state_code: '42', // Region iso2
  },
})

Contributors

任何贡献表示赞赏。 您可以通过以下步骤开始:创建

  1. 此存储库(了解如何执行此操作 此处)。

  2. 克隆分叉的存储库。

  3. 进行更改并创建拉取请求(学习如何做到这一点)。

  4. 我会处理您的拉取请求并提供一些反馈。

Need help?

Ping 我 在 Twitter 上

License

此存储库根据 MIT 许可证获得许可。

不要害羞! ???

:heart: 赞助商

# Countries Service [![NPM](https://nodei.co/npm/@ac-dev/cities-service.png?compact=true)](https://nodei.co/npm/@ac-dev/cities-service/)
[![](https://img.shields.io/npm/dt/@ac-dev/cities-service.svg?style=flat-square)](https://www.npmjs.com/package/@ac-dev/countries-service)

Table of contents

  1. Mission
  2. Getting started
  1. Usage
  2. Contributors
  3. Need help
  4. Licence
  5. Sponsor

Mission

  • I've never found any complete library to get all world countries, states, and cities. I want to develop the best one. Of course, contributors are welcome!!
  • I took this data as a starting point.
  • This package is a part of countries-states-cities-service

Getting started

To get started with this library, you need to install it and add it to your project.

Installation

Cities Service is available as an npm package.

# npm
npm install @ac-dev/cities-service

# yarn
yarn add @ac-dev/cities-service

Import

Import single named import as follow:

import { Cities } from '@ac-dev/cities-service'

Usage

The code snippet below shows how to put into action cities-service in some common use cases.

  • Get all cities.
const cities = Cities.getCities()
  • Get all cities by asc sort.
const cities = Cities.getCities({
  sort: {
    mode: 'asc',
  },
})
  • Get all cities by desc sort.
const cities = Cities.getCities({
  sort: {
    mode: 'desc',
  },
})
  • Get all cities by alphabetical sort.
const cities = Cities.getCities({
  sort: {
    mode: 'alphabetical',
    key: 'name',
  },
})
  • Get Italian cities.
const cities = Cities.getCities({
  filters: {
    country_code: 'IT',
  },
})
  • Get Italian and French cities.
const cities = Cities.getCities({
  filters: {
    country_code: ['IT', 'FR'],
  },
})
  • Get Italian Ligurian cities.
const cities = Cities.getCities({
  filters: {
    country_code: 'IT',
    state_code: '42', // Region iso2
  },
})

Contributors

Any contribution is appreciated. You can get started with the steps below:

  1. Fork this repository (learn how to do this here).

  2. Clone the forked repository.

  3. Make your changes and create a pull request (learn how to do this).

  4. I will attend to your pull request and provide some feedback.

Need help?

Ping me on Twitter

License

This repository is licensed under the MIT License.

Don't be shy! ????

:heart: Sponsor

    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文