Comenzar

Introducción

Con las URLs de Maps, puedes crear una URL universal multiplataforma para iniciar Google Maps, realizar búsquedas, obtener instrucciones sobre cómo llegar y de navegación, y mostrar imágenes panorámicas y vistas de mapa. La sintaxis de la URL es la misma sin importar la plataforma que se use.

No necesitas una clave de API de Google para usar las URLs de Maps.

Sintaxis universal multiplataforma

Como desarrollador de una app para Android, una app para iOS o un sitio web, puedes crear una URL común que abrirá Google Maps y realizará la acción solicitada, independientemente de la plataforma que esté en uso cuando se abra el mapa.

  • En un dispositivo Android:
    • Si la app de Google Maps para Android está instalada y activa, la URL inicia Google Maps en esa app y realiza la acción solicitada.
    • Si la app de Google Maps no está instalada o está inhabilitada, la URL inicia Google Maps en un navegador y realiza la acción solicitada.
  • En un dispositivo iOS:
    • Si está instalada la app de Google Maps para iOS, la URL inicia Google Maps en esa app y realiza la acción solicitada.
    • Si no está instalada la app de Google Maps, la URL inicia Google Maps en un navegador y realiza la acción solicitada.
  • En cualquier otro dispositivo, la URL inicia Google Maps en un navegador y realiza la acción solicitada.

Se recomienda utilizar una URL multiplataforma para iniciar Google Maps desde tu app o sitio web, ya que estas URLs universales permiten un control más amplio de las solicitudes de mapas sin importar la plataforma que se esté utilizando. En el caso de las funciones que solo funcionan en una plataforma para dispositivos móviles (por ejemplo, la navegación paso a paso), te recomendamos que utilices una opción específica de la plataforma para Android o iOS. Consulta la siguiente documentación:

Iniciar Google Maps y realizar una acción específica

Para iniciar Google Maps y, de manera opcional, realizar una de las funciones compatibles, usa un esquema de URL de uno de los siguientes formatos, según la acción solicitada:

  • Búsqueda: Inicia un mapa de Google Maps que muestre un pin de un lugar específico, o bien realiza una búsqueda general y abre un mapa para mostrar los resultados:
    https://www.google.com/maps/search/?api=1&parameters
  • Directions: Solicita instrucciones sobre cómo llegar y, luego, inicia Google Maps con los resultados:
    https://www.google.com/maps/dir/?api=1&parameters
  • Muestra un mapa. Inicia Google Maps sin marcadores ni instrucciones sobre cómo llegar:
    https://www.google.com/maps/@?api=1&map_action=map&parameters
  • Muestra una panorámica de Street View. Inicia una imagen panorámica interactiva:
    https://www.google.com/maps/@?api=1&map_action=pano&parameters

Importante: El parámetro api=1 identifica la versión de las URLs de Maps a la que está destinada esta URL. Este parámetro es obligatorio en todas las solicitudes. El único valor válido es 1. Si api=1 NO está presente en la URL, se ignorarán todos los parámetros y se iniciará la app predeterminada de Google Maps, ya sea en un navegador o en la app para dispositivos móviles de Google Maps, según la plataforma en uso (por ejemplo, https://www.google.com/maps).

Crea URLs válidas

Debes codificar correctamente las URLs.

Por ejemplo, algunos parámetros usan un carácter de barra vertical (|) como separador, que debes codificar como %7C en la URL final. Otros parámetros usan valores separados por comas, como coordenadas de latitud y longitud, o bien Ciudad, Estado. Debes codificar la coma como %2C. Codifica espacios con %20 o reemplázalos por un signo más (+).

Además, las URLs tienen un límite de 2,048 caracteres para cada solicitud. Ten en cuenta este límite cuando construyas tus URL.

Acciones en mapa

Las acciones en mapa disponibles son las siguientes: búsqueda, instrucciones sobre cómo llegar, mostrar un mapa y mostrar una panorámica de Street View. Debes especificar la acción en la URL de la solicitud, junto con los parámetros obligatorios y opcionales. Como es norma en las URLs, los parámetros se separan con el carácter et (&). Para cada acción, la lista de parámetros y sus posibles valores se enumeran en la sección Parámetros de búsqueda.

Buscar

La acción de búsqueda muestra los resultados de una búsqueda en la región visible del mapa. Cuando se busca un lugar específico, el mapa resultante coloca un pin en la ubicación especificada y muestra los detalles disponibles del lugar.

Cómo crear la URL de búsqueda

https://www.google.com/maps/search/?api=1&parameters

Parámetros

  • query (obligatorio): Define los lugares que se deben destacar en el mapa. El parámetro de búsqueda es obligatorio para todas las solicitudes de búsqueda.
    • Especifica las ubicaciones como el nombre de un lugar, una dirección o coordenadas de latitud y longitud separadas por comas. Las cadenas deben estar codificadas en la URL, por lo que una dirección como "Ayuntamiento, Nueva York, NY" debe convertirse en City+Hall%2C+New+York%2C+NY.
    • Especifica los términos de búsqueda generales como una string codificada en la URL, como grocery+stores o restaurants+in+seattle+wa.
  • query_place_id (opcional): Un ID de lugar es un identificador textual que identifica un lugar de forma exclusiva. Para la acción search, debes especificar un query, pero también puedes especificar una query_place_id. Si especificas ambos parámetros, query solo se utilizará si Google Maps no puede encontrar el ID de lugar. Si intentas vincular de forma definitiva a un establecimiento específico, el ID de lugar es la mejor garantía de que realizarás la vinculación con el lugar correcto. También te recomendamos que envíes un query_place_id cuando busques una ubicación específica mediante coordenadas de latitud y longitud.

Ejemplos de búsquedas

Búsqueda de ubicación

En una búsqueda de ubicación, buscas una ubicación específica usando el nombre de un lugar, una dirección o coordenadas de latitud y longitud separadas por comas, y el mapa resultante mostrará un pin en esa ubicación. Estos tres ejemplos ilustran las búsquedas de la misma ubicación, CenturyLink Field (un estadio deportivo en Seattle, WA), con diferentes valores de ubicación.

Ejemplo 1: La búsqueda del nombre del lugar "CenturyLink Field" da como resultado el siguiente mapa:

https://www.google.com/maps/search/?api=1&query=centurylink+field

Ejemplo 2: Cómo buscar el campo CenturyLink con coordenadas de latitud y longitud, así como los resultados del ID de lugar en el siguiente mapa:

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393&query_place_id=ChIJKxjxuaNqkFQR3CK6O1HNNqY

Ejemplo 3: Búsqueda del campo CenturyLink solo con resultados de coordenadas de latitud y longitud en el siguiente mapa Ten en cuenta que hay un pin en el mapa, pero no se proporciona información adicional del lugar en el mapa ni en el panel lateral:

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393

Búsqueda categórica

En una búsqueda por categoría, pasas un término de búsqueda general y Google Maps intenta encontrar fichas que coincidan con tus criterios cerca de la ubicación que especificaste. Si no se especifica una ubicación, Google Maps intenta encontrar fichas cercanas a tu ubicación actual. Si prefieres proporcionar una ubicación para una búsqueda por categoría, inclúyela en la string de búsqueda general (por ejemplo, pizza+seattle+wa).

En este ejemplo, una búsqueda de pizzerías en Seattle, WA, da como resultado el siguiente mapa:

https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa


Directions

Muestra la ruta entre dos o más puntos especificados en el mapa, así como la distancia y la duración del viaje.

Cómo crear la URL de Directions

https://www.google.com/maps/dir/?api=1&parameters

Parámetros

  • origin: Define el punto de partida desde el que se mostrarán las instrucciones sobre cómo llegar. El valor predeterminado es la ubicación de inicio más relevante, como la ubicación del dispositivo, si está disponible. Si no existe ninguno, el mapa resultante puede proporcionar un formulario en blanco para permitir que un usuario ingrese el origen. El valor puede ser el nombre de un lugar, una dirección o coordenadas de latitud y longitud separadas por comas. Las cadenas deben estar codificadas en formato URL, por lo que una dirección como "Ayuntamiento, Nueva York, NY" debe convertirse en City+Hall%2C+New+York%2C+NY.

    Nota: Este parámetro es opcional, a menos que especifiques un origin_place_id en tu URL. Si decides especificar un origin_place_id, también debes incluir un origin en la URL.

  • origin_place_id (opcional): Un ID de lugar es un identificador textual que identifica un lugar de forma exclusiva. Si intentas especificar de forma definitiva un establecimiento, el uso de un ID de lugar es la mejor garantía de vincular el lugar correcto. Las URLs que usan este parámetro también deben incluir un origin.
  • destination: Define el extremo de las instrucciones sobre cómo llegar. Si no existe ninguno, el mapa resultante puede proporcionar un formulario en blanco para permitir que el usuario ingrese el destino. El valor puede ser el nombre de un lugar, una dirección o coordenadas de latitud y longitud separadas por comas. Las cadenas deben estar codificadas en formato URL, por lo que una dirección como "Ayuntamiento, Nueva York, NY" debe convertirse en City+Hall%2C+New+York%2C+NY.

    Nota: Este parámetro es opcional, a menos que especifiques una destination_place_id en tu URL. Si decides especificar un destination_place_id, también debes incluir un destination en la URL.

  • destination_place_id (opcional): Un ID de lugar es un identificador textual que identifica un lugar de forma exclusiva. Si intentas especificar de forma definitiva un establecimiento, el uso de un ID de lugar es la mejor garantía de vincular el lugar correcto. Las URLs que usan este parámetro también deben incluir un destination.
  • travelmode (opcional): Define el medio de transporte. Las opciones son driving, walking (que prefiere rutas peatonales y aceras, cuando estén disponibles), bicycling (que se enruta mediante ciclovías y calles preferidas cuando están disponibles) o transit. Si no se especifica un travelmode, Google Maps muestra uno o más de los modos más relevantes para la ruta especificada o las preferencias del usuario.
  • dir_action=navigate (opcional): Inicia la navegación paso a paso o la vista previa de la ruta para el destino especificado en función de si el origen está disponible o no. Si el usuario especifica un origen y no está cerca de su ubicación actual, o la ubicación actual del dispositivo no está disponible, el mapa inicia una vista previa de la ruta. Si el usuario no especifica un origen (en cuyo caso el origen predeterminado es la ubicación actual del dispositivo) o si el origen está cerca de la ubicación actual del usuario, el mapa inicia la navegación paso a paso. Ten en cuenta que la navegación no está disponible en todos los productos de Google Maps ni entre todos los destinos. En esos casos, se ignorará este parámetro.
  • waypoints: Especifica uno o más lugares intermedios para generar instrucciones sobre cómo llegar entre origin y destination. Se pueden especificar varios puntos de referencia con el carácter de barra vertical (|) para separar lugares (por ejemplo, Berlin,Germany|Paris,France). La cantidad de puntos de referencia permitidos varía según la plataforma en la que se abre el vínculo, con hasta tres puntos de referencia admitidos en los navegadores para dispositivos móviles y hasta nueve puntos de referencia admitidos en caso contrario. Los puntos de referencia se muestran en el mapa en el mismo orden en que se enumeran en la URL. Cada punto de referencia puede ser el nombre de un lugar, una dirección o coordenadas de latitud y longitud separadas por comas. Las cadenas deben estar codificadas en la URL, por lo que los puntos de referencia como "Berlín,Alemania|París,Francia" deben convertirse en Berlin%2CGermany%7CParis%2CFrance.

    Notas:

    • Los puntos de referencia no son compatibles con todos los productos de Google Maps. En esos casos, se ignorará este parámetro.
    • Este parámetro es opcional, a menos que especifiques waypoint_place_ids en tu URL. Si eliges especificar waypoint_place_ids, también debes incluir waypoints en la URL.
  • waypoint_place_ids (opcional): Un ID de lugar es un identificador textual que identifica un lugar de forma exclusiva. Waypoint_place_ids te permite proporcionar una lista de IDs de lugar que coinciden con la lista de waypoints. Los IDs de lugar deben mostrarse en el mismo orden que los puntos de referencia y separarse con el carácter de barra vertical "|" ( codificada para URL como %7C). Si intentas especificar de forma definitiva ciertos establecimientos, los IDs de lugar son la mejor garantía de que te vincularás a los lugares correctos. Las URLs que usan este parámetro también deben incluir waypoints.
  • avoid (opcional): Establece los atributos que la ruta debe intentar evitar. Se puede establecer en una o más de estas opciones, separadas por un carácter de coma "," ( codificada para URL como %2C):
    • ferries
    • highways
    • tolls

Ejemplos de instrucciones sobre cómo llegar

La siguiente URL inicia un mapa en el modo de instrucciones sobre cómo llegar y proporciona un formulario para permitir que el usuario ingrese el origen y el destino.

https://www.google.com/maps/dir/?api=1

En el siguiente ejemplo, se muestra un mapa con instrucciones sobre cómo llegar en bicicleta desde la Aguja Espacial hasta el Mercado de Pike Place, en Seattle, Washington.

https://www.google.com/maps/dir/?api=1&origin=Space+Needle+Seattle+WA&destination=Pike+Place+Market+Seattle+WA&travelmode=bicycling

En el siguiente ejemplo, se muestra un mapa con instrucciones sobre cómo llegar a pie desde Google en Sídney, Australia, hasta el edificio Queen Victoria.

https://www.google.com/maps/dir/?api=1&origin=Google+Pyrmont+NSW&destination=QVB&destination_place_id=ChIJISz8NjyuEmsRFTQ9Iw7Ear8&travelmode=walking


Muestra de un mapa

La acción en mapa devuelve un mapa sin marcadores ni instrucciones sobre cómo llegar.

Cómo crear la URL del mapa

https://www.google.com/maps/@?api=1&map_action=map&parameters

Parámetros

  • map_action=map (obligatorio): Especifica el tipo de vista de mapa que se mostrará. Maps y Street View comparten el mismo extremo. Para garantizar que se muestre un mapa, el map_action debe especificarse como map.
  • center (opcional): Define el centro de la ventana del mapa y acepta coordenadas de latitud y longitud como valores separados por comas (por ejemplo, -33.8569,151.2152).
  • zoom (opcional): Establece el nivel de zoom inicial del mapa. Los valores aceptados son números enteros enteros de 0 (todo el planeta) a 21 (edificios individuales). El límite superior puede variar según los datos del mapa disponibles en la ubicación seleccionada. El valor predeterminado es 15.
  • basemap (opcional): Define el tipo de mapa que se mostrará. El valor puede ser roadmap (predeterminado), satellite o terrain.
  • layer (opcional): Define una capa adicional para mostrar en el mapa, si corresponde. El valor puede ser uno de los siguientes: none (predeterminado), transit, traffic o bicycling.

Ejemplos de mapas

Esta URL de ejemplo inicia un mapa predeterminado de Google Maps centrado en la ubicación actual del usuario.

https://www.google.com/maps/@?api=1&map_action=map

En el siguiente ejemplo, se muestra un mapa centrado en Katoomba, NSW, Australia (en -33.712206,150.311941) y establece los parámetros opcionales zoom y basemap.

https://www.google.com/maps/@?api=1&map_action=map&center=-33.712206%2C150.311941&zoom=12&basemap=terrain


Cómo mostrar una panorámica de Street View

La acción panorámica te permite iniciar un visor para mostrar imágenes de Street View como panorámicas interactivas. Cada panorámica de Street View proporciona una vista de 360 grados desde una ubicación. Las imágenes contienen una vista horizontal de 360 grados (vista envolvente completa) y una vista vertical de 180 grados (desde el extremo superior hasta el inferior). La acción panorámica inicia un visor que renderiza la panorámica resultante como una esfera con una cámara en el centro. Puedes manipular la cámara para controlar el zoom y la orientación de la cámara.

Google Street View proporciona vistas panorámicas de ubicaciones designadas en su área de cobertura. Además, están disponibles fotos esféricas aportadas por los usuarios y recopilaciones especiales de Street View.

Cómo crear la URL de Street View

https://www.google.com/maps/@?api=1&map_action=pano&parameters

Parámetros

  • map_action=pano (obligatorio): Especifica el tipo de vista que se mostrará. Maps y Street View comparten el mismo extremo. Para garantizar que se muestre una panorámica, el action debe especificarse como pano.

También se requiere uno de los siguientes parámetros de URL:

  • viewpoint: El visor muestra la panorámica que se tomó más cerca de la ubicación viewpoint, especificada como coordenadas de latitud y longitud separadas por comas (por ejemplo, 46.414382,10.013988). Debido a que las imágenes de Street View se actualizan de manera periódica y que las fotografías pueden tomarse desde posiciones ligeramente diferentes en cada ocasión, es posible que tu ubicación se adapte a una panorámica diferente cuando se actualicen las imágenes.
  • pano: Es el ID de panorámica específico de la imagen que se mostrará. Si especificas un pano, también puedes especificar un viewpoint. viewpoint solo se usa si Google Maps no puede encontrar el ID de panorámica. Si se especifica pano, pero no se encuentra, y NO se especifica un objeto viewpoint, no se muestra ninguna imagen panorámica. En cambio, Google Maps se abre en modo predeterminado y muestra un mapa centrado en la ubicación actual del usuario.

Los siguientes parámetros de dirección URL son opcionales:

  • heading: Indica la orientación de la cámara con la brújula en grados en el sentido de las manecillas del reloj desde el norte. Los valores aceptados van de -180 a 360 grados. Si se omite, se elige un encabezado predeterminado según el punto de vista (si se especifica) de la búsqueda y la ubicación real de la imagen.
  • pitch: Especifica el ángulo, ascendente o descendente, de la cámara. El tono se especifica en grados de -90 a 90. Los valores positivos orientarán la cámara en un ángulo ascendente, mientras que los valores negativos la orientarán en un ángulo descendente. La inclinación predeterminada de 0 se establece en función de la posición de la cámara cuando se capturó la imagen. Debido a esto, una inclinación de 0 a menudo, pero no siempre, es horizontal. Por ejemplo, una imagen tomada en una colina posiblemente exhiba una inclinación predeterminada que no sea horizontal.
  • fov: Determina el campo visual horizontal de la imagen. El campo visual se expresa en grados, con un rango de 10 a 100. El valor predeterminado es 90. Cuando se trabaja con un viewport de tamaño fijo, el campo visual se considera el nivel de zoom, y los números más pequeños indican un mayor nivel de zoom.

Ejemplos de Street View

Los dos primeros ejemplos muestran una panorámica de la Torre Eiffel. En el ejemplo uno, se usa solo un viewpoint para la ubicación y se establecen los parámetros opcionales heading, pitch y fov. A modo de comparación, en el segundo ejemplo se usa un ID de pano así como los mismos parámetros establecidos en el primer ejemplo. En el tercer ejemplo, se muestra una imagen de panorámica interior.

Ejemplo 1: Usa solo un objeto viewpoint para especificar la ubicación

https://www.google.com/maps/@?api=1&map_action=pano&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

Ejemplo 2: Usa un ID de pano y una ubicación de viewpoint. El ID de pano tiene prioridad sobre el de viewpoint. En este ejemplo, se encuentra el ID de panorámica, por lo que se ignora el objeto viewpoint. Ten en cuenta que la imagen panorámica que se muestra para el ID de pano es ligeramente diferente y más reciente que la imagen que se encuentra usando solo el viewpoint.

https://www.google.com/maps/@?api=1&map_action=pano&pano=tu510ie_z4ptBZYo2BGEJg&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

Ejemplo 3: Muestra una panorámica del interior del restaurante Sarastro en Londres, Reino Unido, especificada con un ID de panorámica.

https://www.google.com/maps/@?api=1&map_action=pano&pano=4U-oRQCNsC6u7r8gp02sLA

Cómo encontrar un ID de panorámica

Para encontrar el ID de una imagen panorámica específica, puedes utilizar varios métodos.

Más ejemplos

Ejemplos de instrucciones sobre cómo llegar con puntos de referencia

En los siguientes ejemplos de instrucciones sobre cómo llegar, se inicia Google Maps y se muestran las rutas en auto desde París, Francia hasta Cherbourg, Francia, y las rutas a través de los siguientes puntos de referencia:

Ciudad, paísNombre del lugarID de lugar
1. Versalles, Francia El Palacio de Versalles ChIJdUyx15R95kcRj85ZX8H8OAU
2. Chartres, Francia Catedral de Chartres ChIJKzGHdEgM5EcR_OBTT3nQoEA
3. Le Mans, Francia Catedral de San Julián de Le Mans CHIJG2LvQNCI4kcRKXNoAsPi1Mc
4. Caen, Francia Castillo de Caen ChIJ06tnGbxCCkgRsfNjEQMwUsc

En las URLs de ejemplo, los puntos de referencia se definen de diferentes maneras para que puedas comparar las diferencias en la visualización de los puntos de referencia en los mapas resultantes.

Ejemplo 1: Puntos de referencia definidos como Ciudad, País:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance

Ejemplo 2: Puntos de referencia definidos como nombres de lugares específicos:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Palace+of+Versailles%7CChartres+Cathedral%7CCathedral+of+Saint+Julian+of+Le+Mans%7CCaen+Castle

Ejemplo 3: Los puntos de referencia se definen como Ciudad, País y también proporcionan waypoint_place_ids para un establecimiento específico en cada punto de referencia:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance&waypoint_place_ids=ChIJdUyx15R95kcRj85ZX8H8OAU%7CChIJKzGHdEgM5EcR_OBTT3nQoEA%7CChIJG2LvQNCI4kcRKXNoAsPi1Mc%7CChIJ06tnGbxCCkgRsfNjEQMwUsc

Ejemplo 4: Define los puntos de referencia como Ciudad, País, pero enumera los puntos de referencia en un orden diferente en comparación con los ejemplos anteriores. Demuestra que el mapa muestra los puntos de referencia en el orden en que se enumeran en la URL.

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CCaen%2CFrance%7CLe+Mans%2CFrance%7CChartres%2CFrance

Ejemplos de mapas

Muestra un mapa con un basemap (satélite) y un layer (transporte público) especificados.

https://www.google.com/maps/@?api=1&map_action=map&center=37.7992940%2C-122.3976113&zoom=15&basemap=satellite&layer=transit

Ejemplos de Street View

Muestra una panorámica de Street View con una clave de imagen FIFE como ID de pano. Ten en cuenta que el ID de pano está precedido por F:.

https://www.google.com/maps/@?api=1&map_action=pano&pano=F:-ud6AZSB-sQg/V0cfCSV3OWI/AAAAAAAAG1U/UQEoc5sXPQEIP7zzD6SWzmKb8Vbug47uQCLIB&heading=22&pitch=-5&fov=55