Pinpoint individual

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"
}

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 (state y state_code). Cuando el nombre y el código son lo mismo, como en zipcode, el campo _code se 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.

Con 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

Authorization

string

header

requerido

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

latitude

number<float>

requerido

Latitud decimal

Ejemplo:

19.7058

longitude

number<float>

requerido

Longitud decimal

Ejemplo:

-101.1949

valid_to

string<date>

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

country

string

Ejemplo:

"México"

country_code

string

Ejemplo:

"mex"

state

string

Ejemplo:

"Michoacán de Ocampo"

state_code

string

Ejemplo:

"16"

municipality

string

Ejemplo:

"Morelia"

municipality_code

string

Ejemplo:

"16053"

zipcode

string

Ejemplo:

"58000"

locality

string

Ejemplo:

"Morelia"

locality_code

string

Ejemplo:

"160530001"

ageb

string

Ejemplo:

"1605300010293"

urban_block

string

Ejemplo:

"1605300010293008"

rural_block

string | null

neighborhood

string | null

Ejemplo:

"Centro Histórico"

neighborhood_code

string | null

Ejemplo:

"1605300010057"

Estadísticas

Lugares

Pinpoint

Catálogos

Ejemplos y guías

Autorizaciones

Parámetros de consulta

Respuesta