curl -X POST "https://client.tukanmx.com/tukan-atlas/places/detail/" \
-H "Authorization: Token $API_TUKAN" \
-H "Content-Type: application/json" \
-d '{
"geo_filter": {"latitude": 19.7060, "longitude": -101.1950, "radius_km": 2},
"filters": {"category_ids": ["bank"]},
"page_size": 100
}'
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
# Bancos a 2 km del centro de Morelia
resp = requests.post(
"https://client.tukanmx.com/tukan-atlas/places/detail/",
headers=headers,
json={
"geo_filter": {"latitude": 19.7060, "longitude": -101.1950, "radius_km": 2},
"filters": {"category_ids": ["bank"]},
"page_size": 100,
},
)
resp.raise_for_status()
for lugar in resp.json()["results"][:3]:
print(lugar["brand_name"], lugar["geography"]["latitude"], lugar["geography"]["longitude"])
{
"count": 34,
"page": 1,
"page_size": 100,
"geo_context": {
"state": "Michoacán de Ocampo",
"municipality": "Morelia",
"zipcode": "58000"
},
"results": [
{
"id": 76504,
"brand_id": 2650,
"brand_name": "BanBajío",
"brand_name_en": "BanBajío",
"institution_id": "BBA940707IE1.MX",
"institution_name": "Banco del Bajío",
"institution_name_en": "Banco del Bajío",
"legal_name": "Banco del Bajío, S.A., Institución de Banca Múltiple",
"geography": {
"latitude": 19.7023379,
"longitude": -101.2079899,
"state": "Michoacán de Ocampo"
},
"categories": ["Cajero automático", "Banco"]
}
]
}
Lugares
Listado por entidad
Obtén los lugares individuales de una zona con su marca, institución, categorías y ubicación.
POST
/
places
/
detail
/
curl -X POST "https://client.tukanmx.com/tukan-atlas/places/detail/" \
-H "Authorization: Token $API_TUKAN" \
-H "Content-Type: application/json" \
-d '{
"geo_filter": {"latitude": 19.7060, "longitude": -101.1950, "radius_km": 2},
"filters": {"category_ids": ["bank"]},
"page_size": 100
}'
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
# Bancos a 2 km del centro de Morelia
resp = requests.post(
"https://client.tukanmx.com/tukan-atlas/places/detail/",
headers=headers,
json={
"geo_filter": {"latitude": 19.7060, "longitude": -101.1950, "radius_km": 2},
"filters": {"category_ids": ["bank"]},
"page_size": 100,
},
)
resp.raise_for_status()
for lugar in resp.json()["results"][:3]:
print(lugar["brand_name"], lugar["geography"]["latitude"], lugar["geography"]["longitude"])
{
"count": 34,
"page": 1,
"page_size": 100,
"geo_context": {
"state": "Michoacán de Ocampo",
"municipality": "Morelia",
"zipcode": "58000"
},
"results": [
{
"id": 76504,
"brand_id": 2650,
"brand_name": "BanBajío",
"brand_name_en": "BanBajío",
"institution_id": "BBA940707IE1.MX",
"institution_name": "Banco del Bajío",
"institution_name_en": "Banco del Bajío",
"legal_name": "Banco del Bajío, S.A., Institución de Banca Múltiple",
"geography": {
"latitude": 19.7023379,
"longitude": -101.2079899,
"state": "Michoacán de Ocampo"
},
"categories": ["Cajero automático", "Banco"]
}
]
}
La versión granular de conteo por entidad. En lugar de conteos regresa cada lugar individual con su marca, institución, coordenadas y categorías, y solo incluye lugares activos.
Acepta el mismo
geo_filter de tres modos (radio, dirección, entidad) y además un objeto filters para acotar por catálogo.
category_ids,brand_idseinstitution_idsincluyen solo esas categorías, marcas o instituciones.exclude_category_ids,exclude_brand_idsyexclude_institution_idshacen lo contrario, todo excepto lo listado.
La paginación va en el cuerpo (
page, page_size), con un máximo de 500 resultados por página.curl -X POST "https://client.tukanmx.com/tukan-atlas/places/detail/" \
-H "Authorization: Token $API_TUKAN" \
-H "Content-Type: application/json" \
-d '{
"geo_filter": {"latitude": 19.7060, "longitude": -101.1950, "radius_km": 2},
"filters": {"category_ids": ["bank"]},
"page_size": 100
}'
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
# Bancos a 2 km del centro de Morelia
resp = requests.post(
"https://client.tukanmx.com/tukan-atlas/places/detail/",
headers=headers,
json={
"geo_filter": {"latitude": 19.7060, "longitude": -101.1950, "radius_km": 2},
"filters": {"category_ids": ["bank"]},
"page_size": 100,
},
)
resp.raise_for_status()
for lugar in resp.json()["results"][:3]:
print(lugar["brand_name"], lugar["geography"]["latitude"], lugar["geography"]["longitude"])
{
"count": 34,
"page": 1,
"page_size": 100,
"geo_context": {
"state": "Michoacán de Ocampo",
"municipality": "Morelia",
"zipcode": "58000"
},
"results": [
{
"id": 76504,
"brand_id": 2650,
"brand_name": "BanBajío",
"brand_name_en": "BanBajío",
"institution_id": "BBA940707IE1.MX",
"institution_name": "Banco del Bajío",
"institution_name_en": "Banco del Bajío",
"legal_name": "Banco del Bajío, S.A., Institución de Banca Múltiple",
"geography": {
"latitude": 19.7023379,
"longitude": -101.2079899,
"state": "Michoacán de Ocampo"
},
"categories": ["Cajero automático", "Banco"]
}
]
}
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.
Cuerpo
application/json
Filtro geográfico. Modos disponibles: radio (latitude, longitude, radius_km), dirección (address, radius_km) o polígono (entity_type, entity_codes).
Show child attributes
Show child attributes
Filtros opcionales de inclusión/exclusión. Se combinan con lógica AND.
Show child attributes
Show child attributes
Rango requerido:
x <= 500¿Esta página le ayudó?