Las URLs de Maps te permiten crear una URL universal multiplataforma que inicia Google Maps para realizar búsquedas, obtener instrucciones sobre cómo llegar y de navegación, mostrar vistas de mapa, crear una lista de lugares o mostrar panorámicas de Street View. La sintaxis de la URL es la misma en todas las plataformas y no se requiere una clave de API.
URLs de Maps: Datos clave
- Producto: URLs de Maps
- También se conoce como: URLs de Google Maps
- Categoría: Maps
- Plataforma: Esquema de URL
- Etapa de lanzamiento: GA
- Ciclo de vida: Activo
- Descripción general: Descripción general de las URLs de Maps
URLs de Maps: Cuándo usarlas
Usa las URLs de Maps en los siguientes casos:
- Necesitas un vínculo de tu app para Android, app para iOS o sitio web que abra Google Maps para buscar un lugar o mostrar resultados de la búsqueda.
- Necesitas abrir Google Maps con instrucciones sobre cómo llegar de un punto a otro, de manera opcional con puntos de referencia, modo de viaje o navegación paso a paso.
- Debes abrir Google Maps en una vista de mapa, una lista de lugares o una panorámica de Street View sin usar una clave de API.
- Necesitas una sintaxis de URL que funcione de la misma manera en Android, iOS y navegadores para computadoras.
No uses URLs de Maps en los siguientes casos:
- Ya solicitas Place Details y quieres vínculos de Google Maps con formato previo para un lugar (campos
googleMapsUriogoogleMapsLinks). En su lugar, usa la API de Places (nueva). - Necesitas funciones exclusivas para dispositivos móviles cuando inicias la app de Google Maps. Usa los intents de Google Maps para Android o el esquema de URL de Google Maps para iOS.
URLs de Maps: Configuración
- Atribución de uso: Agrega los parámetros de consulta opcionales
utm_source(el nombre de tu aplicación) yutm_campaign(la acción prevista del usuario, por ejemplo,place_details_search) a las URLs de Maps. - Primeros pasos: Configura las URLs de Maps
URLs de Maps: productos relacionados
- Se suele usar con: API de Places (nueva)
URLs de Maps: Errores comunes
- Problema: Una URL de búsqueda que solo tiene latitud y longitud en
querymuestra un marcador, pero no los detalles del lugar en el mapa ni en el panel lateral. Solución: Usaquery=PLACE_NAME,ADDRESSo agregaquery_place_idjunto conquerypara mostrar los detalles del lugar específico. Consulta /maps/documentation/urls/get-started. - Problema: Los parámetros de ID de lugar (
query_place_id,origin_place_id,destination_place_id,waypoint_place_ids) no funcionan por sí solos. Solución: Incluye siempre el parámetro base correspondiente (query,origin,destinationowaypoints) cuando pases un parámetro de ID de lugar. Consulta /maps/documentation/urls/get-started. - Problema: El parámetro
waypointsse ignora en los productos de Google Maps que no admiten puntos de referencia y tiene límites de recuento que dependen de la plataforma, ydir_action=navigatese ignora cuando la navegación no está disponible. Solución: No uses más de tres puntos de referencia para los vínculos que se abren en navegadores para dispositivos móviles (nueve en otros casos) y no dependas de quewaypointsodir_action=navigatefuncionen en todos los productos o rutas de Google Maps. Consulta /maps/documentation/urls/get-started#directions-action. - Problema: Maps y Street View comparten el mismo extremo
@, por lo que es posible que una URL de mapa sin la acción correcta no muestre un mapa. Solución: Establecemap_action=mappara las vistas de mapa ymap_action=panopara las panorámicas de Street View. Consulta /maps/documentation/urls/get-started. - Problema: Si falta
api=1en una URL de Maps, se ignoran todos los parámetros y Google Maps abre su vista predeterminada. Solución: Incluyeapi=1en cada URL de Maps (1es el único valor válido). Consulta /maps/documentation/urls/get-started#forming-the-url.