curl -X POST "https://client.tukanmx.com/tukan-atlas/pinpoint/" \
-H "Authorization: Token $API_TUKAN" \
-H "Content-Type: application/json" \
-d '{
"coordinates": [
[19.7060, -101.1950],
[19.4326, -99.1332]
]
}'
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
resp = requests.post(
"https://client.tukanmx.com/tukan-atlas/pinpoint/",
headers=headers,
json={"coordinates": [[19.7060, -101.1950], [19.4326, -99.1332]]},
)
resp.raise_for_status()
for punto in resp.json()["results"]:
print(punto["municipality"], punto["zipcode"])
{
"count": 2,
"page": 1,
"page_size": 100,
"results": [
{
"latitude": 19.706,
"longitude": -101.195,
"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 masivo
Resuelve hasta 10,000 coordenadas o 100 direcciones en una sola llamada.
POST
/
pinpoint
/
curl -X POST "https://client.tukanmx.com/tukan-atlas/pinpoint/" \
-H "Authorization: Token $API_TUKAN" \
-H "Content-Type: application/json" \
-d '{
"coordinates": [
[19.7060, -101.1950],
[19.4326, -99.1332]
]
}'
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
resp = requests.post(
"https://client.tukanmx.com/tukan-atlas/pinpoint/",
headers=headers,
json={"coordinates": [[19.7060, -101.1950], [19.4326, -99.1332]]},
)
resp.raise_for_status()
for punto in resp.json()["results"]:
print(punto["municipality"], punto["zipcode"])
{
"count": 2,
"page": 1,
"page_size": 100,
"results": [
{
"latitude": 19.706,
"longitude": -101.195,
"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"
}
]
}
La versión por lotes de pinpoint individual, pensada para georreferenciar bases de datos completas en una sola llamada, como la cartera de sucursales o los domicilios de tus clientes.
coordinatesacepta hasta 10,000 pares[latitud, longitud].addressesacepta hasta 100 direcciones en texto libre, que se resuelven automáticamente a coordenadas.
page y page_size como parámetros de query. En modo direcciones, las que no se pudieron resolver aparecen en geocode_errors sin abortar el resto.
También acepta valid_to en el cuerpo para resolver contra cartografía histórica.
curl -X POST "https://client.tukanmx.com/tukan-atlas/pinpoint/" \
-H "Authorization: Token $API_TUKAN" \
-H "Content-Type: application/json" \
-d '{
"coordinates": [
[19.7060, -101.1950],
[19.4326, -99.1332]
]
}'
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
resp = requests.post(
"https://client.tukanmx.com/tukan-atlas/pinpoint/",
headers=headers,
json={"coordinates": [[19.7060, -101.1950], [19.4326, -99.1332]]},
)
resp.raise_for_status()
for punto in resp.json()["results"]:
print(punto["municipality"], punto["zipcode"])
{
"count": 2,
"page": 1,
"page_size": 100,
"results": [
{
"latitude": 19.706,
"longitude": -101.195,
"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
Número de página
Resultados por página
Cuerpo
application/json
Lista de pares [latitud, longitud]. Máximo 10,000.
Required array length:
1 - 10000 elementsRequired array length:
2 elementsEjemplo:
[[19.706, -101.195], [19.4326, -99.1332]]
Fecha para consultar versión histórica de polígonos (YYYY-MM-DD). Omitir para la versión actual.
Ejemplo:
"2022-06-01"
Hasta 100 direcciones en texto libre. Se resuelven automáticamente a coordenadas. Mutuamente excluyente con coordinates.
Maximum array length:
100Ejemplo:
[
"Av. Madero Poniente 100, Centro, Morelia, Michoacán"
]
¿Esta página le ayudó?