curl "https://client.tukanmx.com/tukan-atlas/pinpoint/?latitude=19.7060&longitude=-101.1950" \
-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/pinpoint/",
headers=headers,
params={"latitude": 19.7060, "longitude": -101.1950},
)
resp.raise_for_status()
punto = resp.json()
print(punto["municipality"], punto["zipcode"], punto["neighborhood"])
{
"country": "México",
"country_code": "mex",
"state": "Michoacán de Ocampo",
"state_code": "16",
"municipality": "Morelia",
"municipality_code": "16053",
"zipcode": "58000",
"locality": "Morelia",
"locality_code": "160530001",
"ageb": "1605300010293",
"urban_block": "1605300010293008",
"neighborhood": "Centro Histórico",
"neighborhood_code": "1605300010057"
}
Pinpoint
Pinpoint individual
Convierte una coordenada en su jerarquía geográfica completa: del estado a la manzana.
GET
/
pinpoint
/
curl "https://client.tukanmx.com/tukan-atlas/pinpoint/?latitude=19.7060&longitude=-101.1950" \
-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/pinpoint/",
headers=headers,
params={"latitude": 19.7060, "longitude": -101.1950},
)
resp.raise_for_status()
punto = resp.json()
print(punto["municipality"], punto["zipcode"], punto["neighborhood"])
{
"country": "México",
"country_code": "mex",
"state": "Michoacán de Ocampo",
"state_code": "16",
"municipality": "Morelia",
"municipality_code": "16053",
"zipcode": "58000",
"locality": "Morelia",
"locality_code": "160530001",
"ageb": "1605300010293",
"urban_block": "1605300010293008",
"neighborhood": "Centro Histórico",
"neighborhood_code": "1605300010057"
}
Manda una latitud y una longitud, y recibe la entidad que contiene ese punto en cada nivel de la jerarquía, desde el país hasta la manzana.
Hay dos detalles del formato de respuesta que conviene conocer.
- Cada nivel trae su nombre y su código (
stateystate_code). Cuando el nombre y el código son lo mismo, como enzipcode, el campo_codese omite. - Si el punto cae exactamente en la frontera de dos entidades gana la de menor área, así que la respuesta siempre es una sola jerarquía.
valid_to puedes resolver el punto contra la cartografía vigente en una fecha pasada, útil si trabajas con datos históricos y los límites cambiaron desde entonces.
¿Tienes miles de puntos o direcciones en texto?Usa pinpoint masivo que acepta hasta 10,000 coordenadas o 100 direcciones por llamada.
curl "https://client.tukanmx.com/tukan-atlas/pinpoint/?latitude=19.7060&longitude=-101.1950" \
-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/pinpoint/",
headers=headers,
params={"latitude": 19.7060, "longitude": -101.1950},
)
resp.raise_for_status()
punto = resp.json()
print(punto["municipality"], punto["zipcode"], punto["neighborhood"])
{
"country": "México",
"country_code": "mex",
"state": "Michoacán de Ocampo",
"state_code": "16",
"municipality": "Morelia",
"municipality_code": "16053",
"zipcode": "58000",
"locality": "Morelia",
"locality_code": "160530001",
"ageb": "1605300010293",
"urban_block": "1605300010293008",
"neighborhood": "Centro Histórico",
"neighborhood_code": "1605300010057"
}
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
Latitud decimal
Ejemplo:
19.7058
Longitud decimal
Ejemplo:
-101.1949
Fecha para consultar la versión histórica de polígonos activa en esa fecha (YYYY-MM-DD). Omitir para la versión actual.
Ejemplo:
"2022-06-01"
Respuesta
Entidades geográficas del punto obtenidas exitosamente
Ejemplo:
"México"
Ejemplo:
"mex"
Ejemplo:
"Michoacán de Ocampo"
Ejemplo:
"16"
Ejemplo:
"Morelia"
Ejemplo:
"16053"
Ejemplo:
"58000"
Ejemplo:
"Morelia"
Ejemplo:
"160530001"
Ejemplo:
"1605300010293"
Ejemplo:
"1605300010293008"
Ejemplo:
"Centro Histórico"
Ejemplo:
"1605300010057"
¿Esta página le ayudó?