jeffersonsimaogoncalves / cidades-promise

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

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