Referencia rápida de las URLs de Maps

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 googleMapsUri o googleMapsLinks). 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) y utm_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: Errores comunes

  • Problema: Una URL de búsqueda que solo tiene latitud y longitud en query muestra un marcador, pero no los detalles del lugar en el mapa ni en el panel lateral. Solución: Usa query=PLACE_NAME,ADDRESS o agrega query_place_id junto con query para 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, destination o waypoints) cuando pases un parámetro de ID de lugar. Consulta /maps/documentation/urls/get-started.
  • Problema: El parámetro waypoints se ignora en los productos de Google Maps que no admiten puntos de referencia y tiene límites de recuento que dependen de la plataforma, y dir_action=navigate se 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 que waypoints o dir_action=navigate funcionen 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: Establece map_action=map para las vistas de mapa y map_action=pano para las panorámicas de Street View. Consulta /maps/documentation/urls/get-started.
  • Problema: Si falta api=1 en una URL de Maps, se ignoran todos los parámetros y Google Maps abre su vista predeterminada. Solución: Incluye api=1 en cada URL de Maps (1 es el único valor válido). Consulta /maps/documentation/urls/get-started#forming-the-url.