Need help with cidades-promise?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

juniorpb
176 Stars 8 Forks MIT License 30 Commits 2 Opened issues

Description

Busca Cidades por meio da sigla do Estado, DDD e/ou outras formas de encontra-las 📍🏠

Services available

!
?

Need anything else?

Contributors list

# 449,545
JavaScr...
24 commits

Cidades Promise

Busca por cidades utilizando a sigla do Estado ou DDD, integrado diretamente aos serviços do INEP e outras API.

Features

  • Interface Assíncrona.
  • Atualizado em tempo-real por se conectar diretamente aos serviços do INEP.
  • Sempre retorna a resposta rápida.
  • Possui alta disponibilidade.
  • Sem limites de uso (rate limits) conhecidos.
  • Suporte ao Node.js

Como utilizar

Realizando uma consulta

Basta utilizar a sigla do estado como parâmetro, por exemplo o estado da Paraíba:

const cidades = require('cidades-promise');

cidades.getCitiesByState("pb").then((res) => { console.log(res); })

// [ // 'AGUA BRANCA', // 'AGUIAR', // 'ALAGOA GRANDE', // 'ALAGOA NOVA', // ... more items // ]

Usando async:

const cidades = require('cidades-promise');

async function getCidades(){ const response = await cidades.getCitiesByState("pb"); console.log(response); }

// [ // 'AGUA BRANCA', // 'AGUIAR', // 'ALAGOA GRANDE', // 'ALAGOA NOVA', // ... more items // ]

Quando a Sigla do Estado possui um formato inválido

const cidades = require('cidades-promise');

cidades.getCitiesByState("pbkj").then((res) => { console.log(res); })

// {"erro":"Sigla do estado estar incorreta"}

Quando a Sigla do Estado não é encontrada

const cidades = require('cidades-promise');

cidades.getCitiesByState("gg").then((res) => { console.log(res); })

// {"erro": "Erro ao buscar cidades"}

Busca Cidades por DDD

const cidades = require('cidades-promise');

cidades.getCitiesByDdd(83).then((res) => { console.log(res); })

// { // estado: 'PB', // cidades: [ // 'Água Branca', // 'Aguiar', // 'Alagoa Grande', // ... more items // ] // }

Instalação

npm

$ npm install --save cidades-promise

Autor

|
@juniorpb
| | :---: |

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.