Necesitas permitir que los usuarios busquen lo que está cerca, mostrar una dirección para un pin en un mapa y obtener fotos y reseñas de un lugar—esta semana. Al final de este artículo, podrás llamar a los endpoints de ubicación en el Google Maps API de Zyla para buscar un lugar, resolver "qué hay aquí" por lat/lng y obtener fotos y reseñas para un ID de lugar.
Lo que esta API te ofrece
La API de Google Maps en Zyla proporciona:
- Búsqueda: encuentra lugares por consulta de texto con coordenadas, dirección, fotos y place_id.
- Qué hay aquí: búsqueda inversa de dirección y contexto de negocios cercanos para un lat/lng.
- Fotos del lugar: recupera fotos de un lugar usando su Place ID.
- Reseñas del lugar: recupera reseñas de usuarios para un lugar por Place ID.
Estos endpoints alimentan la búsqueda de ubicación, experiencias de "tocar en el mapa" y vistas de detalles de lugares en aplicaciones web y móviles.
Comenzando en Zyla API Hub
Abre la página de la API en Zyla API Hub, haz clic en Suscribirse o Comenzar prueba de 7 días cuando esté disponible, y obtén tu clave API. Zyla funciona con un modelo de suscripción y cuota (no pago por llamada). Para esta API, puedes comenzar con una prueba de 7 días o 50 solicitudes—verifica la página de la API para las opciones de acceso y precios actuales.
Autentica cada solicitud con un encabezado HTTP:
- Authorization: Bearer YOUR_API_KEY
El mercado agrega más de 10,000 APIs públicas; una cuenta y una clave API funcionan en todos los servicios, con facturación consistente. Crea una cuenta gratuita y obtén una clave directamente desde la página de la API: Comienza prueba de 7 días en Google Maps API.
Endpoints que usarás
1) Búsqueda
Encuentra lugares por texto. El ejemplo a continuación busca “Berlín” en un nivel de zoom dado.
Método: GET
URL: https://zylalabs.com/api/10107/google-maps-api/19301/search
Parámetros de consulta (del ejemplo): query, zoom
curl -s -X GET "https://zylalabs.com/api/10107/google-maps-api/19301/search?query=Berlín&zoom=13" \
-H "Authorization: Bearer YOUR_API_KEY"
Respuesta de ejemplo:
{
"status": "ok",
"data": [
{
"business_id": "0x47a84e373f035901:0x42120465b5e3b70",
"phone_number": null,
"name": "Berlín",
"full_address": "Berlín, Alemania",
"full_address_array": [
"Alemania"
],
"latitude": 52.520006599999995,
"longitude": 13.404954,
"review_count": null,
"rating": null,
"timezone": "Europa/Berlín",
"website": null,
"place_id": "ChIJAVkDPzdOqEcRcDteW0YgIQQ",
"place_link": "https://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x47a84e373f035901:0x42120465b5e3b70",
"types": null,
"price_level": null,
"working_hours": [],
"city": "Berlín, Alemania",
"is_claimed": false,
"verified": true,
"is_permanently_closed": false,
"is_temporarily_closed": false,
"photos": [
{
"src": "https://lh3.googleusercontent.com/grass-cs/AABkmLffehkFWQeKJcoSb-1YW6L8asBOURQlYg7lDTzlg-TUUjHcP_iZA3YCo6lc1vSKHWpq9OwDIyiwB46OCe5IRwpsCCci5585tr4m6FnBlKPsaS3WVsEA1la8CVcIMhti5jyCmVBW=w203-h126-k-no",
"max_size": [
4963,
3102
],
"min_size": [
203,
100
]
},
{
"src": "https://lh3.googleusercontent.com/grass-cs/AABkmLcK-9P8aapCvGa0e5zeC2wBQm0Y01228VvLazWmPdE7yc_geBaO7DanSWf59BJSHospUgsiE7K6-VjWpB8b3c03ZfvnHzx3LwM50nvfCQ-DCaXA_fqLDhHnTrbcYAfCIzDumboTPQ=w203-h152-k-no",
"max_size": [
12000,
9000
],
"min_size": [
203,
100
]
},
{
"src": "https://lh3.googleusercontent.com/grass-cs/AABkmLfHzbwqyGh-qbjub4sgIBqFw1JqsU9wA-fOOAcEaQi24vqQnx47CebTSe9LxHMr6MfXW2M62qX94rtnpMeS9oFWfll0cW1avvFvgg1PWymyOTAen250DP6tK-Q_cVGIGL003WPOow=w203-h152-k-no",
"max_size": [
4032,
3024
],
"min_size": [
203,
100
]
},…
Lo que realmente usarás:
- name, full_address, city: mostrar títulos y resúmenes de resultados.
- latitude, longitude: centrar un mapa o calcular proximidad.
- place_id, place_link: enlace profundo o obtener detalles (por ejemplo, fotos, reseñas).
- timezone: mostrar horas locales para horarios comerciales; los valores siguen IANA (por ejemplo, Europa/Berlín).
- photos[n].src: mostrar miniaturas; max_size/min_size son dimensiones en píxeles.
2) Qué hay aquí
Búsqueda inversa de dirección y contexto cercano para coordenadas. Útil para flujos de “presionar largo en el mapa” o convertir GPS en una dirección legible.
Método: GET
URL: https://zylalabs.com/api/10107/google-maps-api/19306/what-is-here
Parámetros de consulta requeridos:
- lat (string): por ejemplo, 48.8719556
- lng (string): por ejemplo, 2.3415407
Ejemplo de solicitud (parámetros mostrados para claridad):
https://zylalabs.com/api/10107/google-maps-api/19306/what-is-here?lat=48.8719556&lng=2.3415407
Ejemplo de respuesta (campos abreviados):
Usa la dirección y la zona horaria para la interfaz de usuario, place_id para llamadas posteriores y coordenadas para la alineación del mapa. Los valores son grados lat/lng estándar y nombres de zona horaria IANA.
3) Fotos del lugar
Obtén fotos de un lugar específico usando su Place ID. Ideal para mostrar una galería de fotos en una página de detalles de ubicación.
Método: GET
URL: https://zylalabs.com/api/10107/google-maps-api/19307/place-photos
Parámetros de solicitud: ninguno está documentado aquí más allá de la autenticación. Úsalo para recuperar fotos asociadas con un lugar.
4) Reseñas del lugar
Recupera reseñas de usuarios para un lugar por Place ID para enriquecer las páginas de detalles con calificaciones y comentarios.
Método: GET
URL: https://zylalabs.com/api/10107/google-maps-api/19305/place-reviews
Parámetros de solicitud: ninguno está documentado aquí más allá de la autenticación.
Código para copiar y pegar: Buscar y analizar resultados
El fragmento a continuación llama al endpoint de Búsqueda, lee coordenadas y extrae campos necesarios para una interfaz de usuario simple de “búsqueda cercana”. Reemplaza YOUR_API_KEY con tu clave de Zyla.
import requests
API_KEY = "YOUR_API_KEY"
url = "https://zylalabs.com/api/10107/google-maps-api/19301/search"
params = {
"query": "Berlin",
"zoom": "13"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, headers=headers, params=params, timeout=20)
resp.raise_for_status()
payload = resp.json()
if payload.get("status") == "ok":
results = payload.get("data", [])
for item in results:
name = item.get("name")
address = item.get("full_address")
lat = item.get("latitude")
lng = item.get("longitude")
place_id = item.get("place_id")
timezone = item.get("timezone")
photos = item.get("photos", [])
# Imprimir una línea compacta para tu UI o registros
print(f"{name} | {address} | {lat},{lng} | place_id={place_id} | tz={timezone}")
# Usar la primera foto si está disponible
if photos:
first_photo_url = photos[0].get("src")
print(f"Miniatura: {first_photo_url}")
else:
raise RuntimeError(f"La búsqueda falló: {payload}")
Notas de diseño que te ahorrarán tiempo
- Zonas horarias: La API devuelve nombres IANA (por ejemplo, Europa/Berlín). Úsalos directamente con tus bibliotecas de tiempo para localizar horarios comerciales y marcas de tiempo.
- Coordenadas: La latitud y longitud son grados decimales. Para ordenar por proximidad, calcula la distancia en línea recta o usa cajas de delimitación alrededor de la ubicación del usuario.
- Miniaturas: La respuesta de Búsqueda ya incluye fotos con diferentes tamaños. Almacena las URL de fotos en tu lado para reducir cargas posteriores.
- Place IDs: Almacena place_id de Búsqueda o Qué hay aquí si planeas obtener fotos o reseñas más tarde. Es el identificador estable que vincula los endpoints.
- Cuotas: Zyla utiliza suscripción + cuota, no pago por llamada. Monitorea el uso en tu panel. La lista de Google Maps API ofrece una prueba de 7 días o 50 solicitudes para comenzar.
Juntándolo todo: Flujo de búsqueda cercana
Un flujo mínimo de “búsqueda cercana” a menudo necesita tres pantallas: un cuadro de búsqueda, una lista de mapas y un detalle del lugar. Aquí te mostramos cómo mapear cada paso a los endpoints anteriores.
- El usuario escribe un término: llama a Búsqueda con query y zoom para obtener candidatos con coordenadas, zona horaria, fotos y place_id.
- El usuario toca en el mapa: llama a Qué hay aquí con lat/lng para mostrar una dirección legible y capturar el place_id para detalles más profundos.
- El usuario abre un lugar: usa place_id para cargar Fotos del Lugar y Reseñas del Lugar para enriquecer la página de detalles.
Para mejorar el rendimiento, almacena en caché las respuestas de búsqueda por query+zoom para un TTL corto (por ejemplo, unos minutos). Cuando un usuario arrastra el mapa, solo vuelve a consultar cuando el centro cambia más allá de tu umbral.
Referencias de endpoints con ejemplos
Búsqueda
GET https://zylalabs.com/api/10107/google-maps-api/19301/search
Ejemplo de solicitud (del ejemplo oficial):
https://zylalabs.com/api/10107/google-maps-api/19301/search?query=Berlín&zoom=13
Qué hay aquí
GET https://zylalabs.com/api/10107/google-maps-api/19306/what-is-here
Parámetros requeridos: lat, lng
Ejemplo de solicitud:
https://zylalabs.com/api/10107/google-maps-api/19306/what-is-here?lat=48.8719556&lng=2.3415407
Fotos del lugar
GET https://zylalabs.com/api/10107/google-maps-api/19307/place-photos
No se documentan parámetros de solicitud aquí más allá de la autenticación.
Reseñas del lugar
GET https://zylalabs.com/api/10107/google-maps-api/19305/place-reviews
No se documentan parámetros de solicitud aquí más allá de la autenticación.
Llama a la API desde agentes de IA a través de MCP
Cada API en Zyla también se puede llamar desde clientes compatibles con MCP (Claude Code, Cursor, Windsurf y otros). Apunta tu cliente al endpoint de MCP y proporciona tu clave:
- Endpoint: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Desde allí, tus herramientas de agente pueden invocar los mismos endpoints de Google Maps API documentados arriba. Consulta la documentación de MCP para la configuración en tu editor o entorno de agente preferido.
Casos de uso del mundo real que puedes implementar esta semana
- Localizador de tiendas: busca “café cerca de Mitte” con Búsqueda, luego muestra horarios y fotos en páginas de detalles con Fotos del Lugar y etiquetas conscientes de la zona horaria.
- Toque en el mapa para dirección: cuando los usuarios presionan largo en el mapa, llama a Qué hay aquí para mostrar una tarjeta de dirección y habilitar “Guardar esta ubicación”.
- Guía de la ciudad: prefetch resultados de Búsqueda para consultas populares; usa place_id para hidratar páginas de detalles con Reseñas del Lugar para una mejor toma de decisiones.
- Radio de reserva o entrega: filtra resultados de Búsqueda por distancia desde la posición del usuario y muestra solo elementos dentro de tu radio de servicio.
Consejos para solucionar problemas
- Fallos de autorización: asegúrate del formato exacto del encabezado Authorization: Bearer YOUR_API_KEY y sin espacios en blanco adicionales.
- Resultados escasos: ajusta tu texto de consulta (por ejemplo, agrega un nombre de ciudad) o cambia el zoom para ampliar/reducir el contexto de búsqueda.
- Interfaces de usuario sensibles al tiempo: usa el campo de zona horaria de las respuestas para localizar horarios de apertura y tiempos visibles para el usuario.
- Confiabilidad de la red: aplica tiempos de espera cortos y reintentos básicos en errores transitorios; almacena en caché campos estables como place_id y dirección.
FAQ
¿Cómo me autentico?
Envía Authorization: Bearer YOUR_API_KEY en cada solicitud.
¿Hay un plan gratuito?
No. Esta API funciona con suscripción + cuota. Consulta la página de la API para las opciones de acceso actuales; puedes comenzar una prueba de 7 días o usar 50 solicitudes para evaluar.
¿Cómo obtengo fotos o reseñas de un lugar?
Usa place_id de Búsqueda o Qué hay aquí, luego llama a Fotos del Lugar o Reseñas del Lugar respectivamente.
¿Qué unidades son latitud/longitud?
Grados decimales. Las zonas horarias son cadenas IANA como Europa/París.
¿Puedo llamar a esto desde un agente de IA?
Sí. Usa el endpoint de MCP (https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY) en un cliente compatible con MCP e invoca los mismos endpoints.
¿Listo para implementar tu búsqueda cercana? Crea tu cuenta en Zyla API Hub y comienza la prueba de 7 días directamente en la lista: Comienza prueba de 7 días en Google Maps API.