curl "https://client.tukanmx.com/tukan-atlas/geo-entities/?entity_type_id=MUNICIPALITY&name=morelia" \
-H "Authorization: Token $API_TUKAN"
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
resp = requests.get(
"https://client.tukanmx.com/tukan-atlas/geo-entities/",
headers=headers,
params={"entity_type_id": "MUNICIPALITY", "name": "morelia"},
)
resp.raise_for_status()
entity = resp.json()["results"][0]
print(entity["entity_id"], entity["entity_code"], entity["name"])
{
"count": 1,
"page": 1,
"page_size": 100,
"results": [
{
"entity_id": 1051,
"entity_code": "16053",
"entity_type_id": "MUNICIPALITY",
"name": "Morelia",
"name_en": "Morelia",
"parent_code": "16",
"parent_name": "Michoacán de Ocampo"
}
]
}
Catálogos
Entidades
Encuentra cualquier entidad geográfica de México por nombre, código o jerarquía.
GET
/
geo-entities
/
curl "https://client.tukanmx.com/tukan-atlas/geo-entities/?entity_type_id=MUNICIPALITY&name=morelia" \
-H "Authorization: Token $API_TUKAN"
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
resp = requests.get(
"https://client.tukanmx.com/tukan-atlas/geo-entities/",
headers=headers,
params={"entity_type_id": "MUNICIPALITY", "name": "morelia"},
)
resp.raise_for_status()
entity = resp.json()["results"][0]
print(entity["entity_id"], entity["entity_code"], entity["name"])
{
"count": 1,
"page": 1,
"page_size": 100,
"results": [
{
"entity_id": 1051,
"entity_code": "16053",
"entity_type_id": "MUNICIPALITY",
"name": "Morelia",
"name_en": "Morelia",
"parent_code": "16",
"parent_name": "Michoacán de Ocampo"
}
]
}
Busca cualquier entidad geográfica de México por nombre, código o jerarquía.
Es el endpoint que usas para resolver “¿cuál es el
entity_id de Morelia?” antes de pedir observaciones. Los dos patrones más comunes son estos.
- Resolver una entidad por nombre. Combina
entity_type_idconname, como en?entity_type_id=MUNICIPALITY&name=morelia. - Listar las hijas de una entidad. Usa
parent_code, como en?entity_type_id=MUNICIPALITY&parent_code=16, que regresa los 113 municipios de Michoacán.
Los filtros por campo tienen prioridad sobre
search. Si mandas cualquier filtro (entity_type_id, name, parent_code…), el parámetro search se ignora por completo. Para acotar por tipo y nombre a la vez, usa entity_type_id + name, no entity_type_id + search.Para saber qué entidades rodean a la que encontraste, usa entidades vecinas. Para sus indicadores, como población, nivel socioeconómico o precios, pásale el
entity_id a últimas observaciones.curl "https://client.tukanmx.com/tukan-atlas/geo-entities/?entity_type_id=MUNICIPALITY&name=morelia" \
-H "Authorization: Token $API_TUKAN"
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
resp = requests.get(
"https://client.tukanmx.com/tukan-atlas/geo-entities/",
headers=headers,
params={"entity_type_id": "MUNICIPALITY", "name": "morelia"},
)
resp.raise_for_status()
entity = resp.json()["results"][0]
print(entity["entity_id"], entity["entity_code"], entity["name"])
{
"count": 1,
"page": 1,
"page_size": 100,
"results": [
{
"entity_id": 1051,
"entity_code": "16053",
"entity_type_id": "MUNICIPALITY",
"name": "Morelia",
"name_en": "Morelia",
"parent_code": "16",
"parent_name": "Michoacán de Ocampo"
}
]
}
Autorizaciones
Token de autenticación. Formato requerido: Token tu-token (la palabra Token, un espacio y tu token). Solicita tu token escribiendo a contacto@tukanmx.com.
Parámetros de consulta
Número de página
Resultados por página
Búsqueda global en entity_code, name, name_en y parent_code
Ejemplo:
"morelia"
Código geográfico exacto de la entidad
Ejemplo:
"16053"
Tipo de entidad geográfica (coincidencia exacta)
Opciones disponibles:
COUNTRY, STATE, MUNICIPALITY, ZIPCODE, LOCALITY, AGEB, URBAN_BLOCK, RURAL_BLOCK, NEIGHBORHOOD Ejemplo:
"MUNICIPALITY"
Filtro por nombre en español (coincidencia parcial)
Ejemplo:
"morelia"
Filtro por nombre en inglés (coincidencia parcial)
Ejemplo:
"méxico city"
Código de la entidad padre (coincidencia exacta). Útil para listar todos los municipios de un estado.
Ejemplo:
"09"
¿Esta página le ayudó?