sipitalie/citiesao

Project to list cities in Angola

API citiesAO

cities-ao

https://cities-ao.onrender.com/api/v1/cities

📝 Description

API-REST created in #nodejs with the purpose of providing a list of cities in Angola.

All data available in the API was extracted from the Government of Angola website governo.gov.ao

📚 Functionalities

• list of cities in Angola

[
    { 
        "id":"luanda",
        "name":"Luanda",
        "capital":"Luanda",
        "counties":[
            {"id":"icoloebengo","name":"Icolo-e-Bengo","communes":["Cassoneca","Cabiri","Bom Jesus","Caculo Cahango","Quiminha"],"districts":["Catete","Bela Vista"]},
            {"id":"luanda","name":"Luanda","communes":[""],"districts":["Sambizanga","Rangel","Maianga","Ingombota","Samba","Neves Bendinha","Ngola Kiluanje"]},
            {"id":"quicama","name":"Quiçama","communes":["Muxima","Demba Chio","Quixinge","Mumbondo","Caboledo"],"districts":[]},
            {"id":"cacuaco","name":"Cacuaco","communes":["Cacuaco","Quicolo","Funda"],"districts":["Kikolo","Cacuaco","Mulenvos de Baixo","Sequele"]},
            {"id":"cazenga","name":"Cazenga","communes":[""],"districts":["Cazenga","Hoji ya Henda","11 de Novembro","Kima Kieza","Tala Hadi","Kalawenda"]},
            {"id":"viana","name":"Viana","communes":["Calumbo"],"districts":["Viana","Estalagem","Kikuxi","Baía","Zango","Vila Flôr"]},
            {"id":"belas","name":"Belas","communes":["Camama","Benfica","Vila Estoril","Ilha do Mussulo","Barra do Kwanza","Futungo de Belas","Ramiro"],"districts":["Quenguela","Morro dos Veados","Ramiros","Vila Verde","Cabolombo","Kilamba"]},
            {"id":"kilamba_kiaxi","name":"Kilamba Kiaxi","communes":[""],"districts":["Golfe","Sapú","Palanca","Nova Vida"]},
            {"id":"talatona","name":"Talatona","communes":["Mussulo"],"districts":["Benfica","Futungo de Belas","Lar do Patriota","Talatona","Camama","Cidade Universitária"]}]
    }
]

🔧 Technologies used

• express
• nodejs
• nodemon

🚀 Running the project

• Installing dependencies

npm ci

• Start the project in development mode

npm rum dev

• Start the project in production mode

npm rum start

🔜 Future implementation

• indication of the ethnicity of each city and its extension

🤝 Collaborators

sipitalie