{
cities: 128768,
countries: 249,
continents: 7,
languages: 185
}This endpoint returns a list of cities (see City model below)
PATH:
/cities/
/countries/
Method:
GET
URL Params
-
Required:
query=[url encoded string] -
Optional:
populate=[boolean] // defaults to true
Data Params
No needed
Success Response:
Code: 200 OK
Content: City[]
Error Response:
Code: 400 BAD REQUEST
Content: {"error": "No query provided."}
OR
Code: 400 BAD REQUEST
Content: {"error": "Too many results. Consider being more specific.", "matches": [integer]}
- Sample Call:
$ curl -X GET "127.0.0.1:5000/cities/?query=sao+paulo&populate=false"$ curl -X GET "127.0.0.1:5000/countries/?query=brazil&populate=true"# input
> $ python ./search.py cities "sao paulo" true
# output
[
{
"_id": "5fa0b349b20d4824443f6c89",
"name": "São Paulo do Potengi",
"lat": "-5.895",
"lng": "-35.76278",
"country": "5fa08226bea7a74c5c69abfa"
},
{
"_id": "5fa0b349b20d4824443f6f2e",
"name": "São Paulo",
"lat": "-23.5475",
"lng": "-46.63611",
"country": "5fa08226bea7a74c5c69abfa"
},
{
"_id": "5fa0b349b20d4824443f73c0",
"name": "São Paulo de Olivença",
"lat": "-3.37833",
"lng": "-68.8725",
"country": "5fa08226bea7a74c5c69abfa"
}
]
Elapsed time: 0.9119657{
"_id": "5fa0b349b20d4824443f6f2e",
"name": "São Paulo",
"lat": "-23.5475",
"lng": "-46.63611",
"country": "5fa08226bea7a74c5c69abfa"
}{
"_id": "5fa08226bea7a74c5c69abfa",
"currency": ["BRL"],
"languages": ["5fa06fb848b4572eb409287b"],
"name": "Brazil",
"native": "Brasil",
"phone": "55",
"capital": "Brasília",
"initials": "BR",
"continent": "5fa07297a260950fb890031c"
}{
"_id": "5fa07297a260950fb890031c",
"name": "South America",
"initials": "SA"
}{
"_id": "5fa06fb848b4572eb409287b",
"name": "Portuguese",
"native": "Português",
"initials": "pt"
}Feel free to send a PR whenever you want
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent