Introducción
Con las URL 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, independientemente de la plataforma en uso.
No necesitas una clave de API de Google para usar las URL de Maps.
Sintaxis universal de plataforma
Como desarrollador de una app para Android, iOS o un sitio web, puedes construir una URL común, y se abrirá Google Maps y realizará la acción solicitada, sin importar la plataforma 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 la app de Maps 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 la app de Google Maps para iOS está instalada, la URL inicia Google Maps en la app de Maps y realiza la acción solicitada.
- Si la app de Google Maps no está instalada, 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.
Te recomendamos que uses una URL multiplataforma para iniciar Google Maps desde tu app o sitio web, ya que estas URL universales permiten un manejo más amplio de las solicitudes de mapas sin importar la plataforma que se use. Para las características que tal vez solo funcionen en una plataforma para dispositivos móviles (por ejemplo, navegación paso a paso), es posible que prefieras usar una opción específica de la plataforma para Android o iOS. Consulta la siguiente documentación:
- Intents de Google Maps para Android: Específicamente, para lanzar la app de Google Maps para Android.
- Esquema de URL de Google Maps para iOS: Específicamente, para lanzar la app de Google Maps para iOS
Iniciar Google Maps y realizar una acción específica
Para iniciar Google Maps y, de forma 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 para un lugar específico o realiza una búsqueda general y, luego, inicia un mapa para mostrar los resultados:
https://www.google.com/maps/search/?api=1¶meters
- Directions: Solicita instrucciones sobre cómo llegar e inicia Google Maps con los resultados:
https://www.google.com/maps/dir/?api=1¶meters
- Muestra un mapa: Inicia Google Maps sin marcadores ni instrucciones sobre cómo llegar:
https://www.google.com/maps/@?api=1&map_action=map¶meters
- Cómo mostrar una panorámica de Street View: Inicia una imagen panorámica panorámica:
https://www.google.com/maps/@?api=1&map_action=pano¶meters
Importante: El parámetro api=1
identifica la versión de las URL de Maps para las 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á 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 URL válidas
Debes codificar correctamente las URL.
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 la ciudad o el estado. Debes codificar la coma como %2C
. Codifica los espacios con %20
o reemplázalos por un signo más (+
).
Además, cada URL tiene un límite de 2,048 caracteres. Ten en cuenta este límite cuando construyas tus URL.
Acciones en mapa
Las acciones disponibles en el mapa son: búsqueda, instrucciones sobre cómo llegar, visualización de un mapa y visualización de 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 estándar en las URL, separa los parámetros mediante el carácter de unión (&
). Para cada acción, se enumeran la lista de parámetros y sus posibles valores en la sección Search Parameters (Parámetros de búsqueda).
Buscar
La acción de búsqueda muestra resultados para una búsqueda en la región visible del mapa. Cuando se busca un lugar específico, el mapa resultante coloca un marcador en la ubicación especificada y muestra los detalles del lugar disponibles.
Formación de la URL de búsqueda
https://www.google.com/maps/search/?api=1¶meters
Parámetros
query
(obligatorio): Define los lugares que se deben destacar en el mapa. El parámetro de consulta es obligatorio para todas las solicitudes de búsqueda.- Especifica las ubicaciones como el nombre de un lugar, la dirección o las coordenadas de latitud y longitud separadas por comas. Las strings deben estar codificadas como URL, por lo que una dirección como “City Hall, New 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
orestaurants+in+seattle+wa
.
- Especifica las ubicaciones como el nombre de un lugar, la dirección o las coordenadas de latitud y longitud separadas por comas. Las strings deben estar codificadas como URL, por lo que una dirección como “City Hall, New York, NY” debe convertirse en
query_place_id
(opcional): Un ID de lugar es un identificador textual que identifica un lugar de forma exclusiva. Para la acciónsearch
, debes especificar unquery
, pero también puedes especificar unquery_place_id
. Si especificas ambos parámetros,query
solo se usa si Google Maps no puede encontrar el ID de lugar. Si intentas establecer un vínculo definitivo con un establecimiento específico, el ID de lugar es la mejor garantía de que te vincularás con el lugar correcto. También se recomienda enviar unquery_place_id
cuando consultes una ubicación específica con 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 con el nombre de un lugar, una dirección o las coordenadas de latitud y longitud separadas por comas, y el mapa resultante muestra un marcador en esa ubicación. Estos tres ejemplos ilustran las búsquedas para la misma ubicación, CenturyLink Field, un estadio deportivo en Seattle, Washington, con diferentes valores de ubicación.
Ejemplo 1: Si buscas el nombre de lugar "CenturyLink Field", se mostrará el siguiente mapa:
https://www.google.com/maps/search/?api=1&query=centurylink+field
Ejemplo 2: Si buscas el campo CenturyLink mediante coordenadas de latitud y longitud, además de los ID de lugar, se genera el siguiente mapa:
Ejemplo 3: Si buscas el campo CenturyLink solo con las coordenadas de latitud y longitud, genera el siguiente mapa. Ten en cuenta que hay un marcador en el mapa, pero no se proporciona información adicional sobre el 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 categórica, 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 ninguna ubicación, Google Maps intenta encontrar fichas cercanas a tu ubicación actual. Si prefieres proporcionar una ubicación para una búsqueda categórica, incluye la ubicación 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
La acción Directions muestra la ruta entre dos o más puntos especificados en el mapa, así como la distancia y el tiempo de viaje.
Cómo crear la URL de las instrucciones sobre cómo llegar
https://www.google.com/maps/dir/?api=1¶meters
Parámetros
origin
: Define el punto de partida desde el que se deben mostrar 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. De lo contrario, el mapa resultante puede proporcionar un formulario en blanco para permitir que un usuario ingrese el origen. El valor puede ser un nombre de lugar, una dirección o coordenadas de latitud y longitud separadas por comas. Una string debe estar codificada como URL, por lo que una dirección como “Municipalidad, Nueva York, Nueva York” debe convertirse enCity+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 unorigin_place_id
, también debes incluir unorigin
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, usar un ID de lugar es la mejor garantía de que te vincularás con el lugar correcto. Las URL que usan este parámetro también deben incluir unorigin
.destination
: Define el extremo de las instrucciones sobre cómo llegar. De lo contrario, el mapa resultante puede proporcionar un formulario en blanco para permitir que el usuario ingrese el destino. El valor puede ser un nombre de lugar, una dirección o coordenadas de latitud y longitud separadas por comas. Una string debe estar codificada como URL, por lo que una dirección como “Municipalidad, Nueva York, Nueva York” debe convertirse enCity+Hall%2C+New+York%2C+NY
.Nota: Este parámetro es opcional, a menos que especifiques un
destination_place_id
en tu URL. Si decides especificar undestination_place_id
, también debes incluir undestination
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, usar un ID de lugar es la mejor garantía de que te vincularás con el lugar correcto. Las URL que usan este parámetro también deben incluir undestination
.travelmode
(opcional): Define el medio de transporte. Las opciones sondriving
,walking
(que prefiere caminos peatonales y veredas, cuando están disponibles),bicycling
(que se orienta mediante ciclovías y calles preferidas, otransit
). Si no se especifica untravelmode
, 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 ruta al destino especificado, según si el origen está disponible. Si el usuario especifica un origen y no está cerca de la ubicación actual del usuario, 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 valor predeterminado es la ubicación actual del dispositivo) o 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 omitirá este parámetro.waypoints
: Especifica uno o más lugares intermedios para el enrutamiento de rutas entreorigin
ydestination
. Se pueden especificar varios puntos de referencia mediante el carácter de barra vertical (|
) para separar los 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. De lo contrario, se admiten hasta tres puntos de referencia en los navegadores para dispositivos móviles y se admite un máximo de nueve. Los puntos de referencia se muestran en el mapa en el mismo orden en el que se enumeran en la URL. Cada punto de referencia puede ser un nombre de lugar, una dirección o coordenadas de latitud y longitud separadas por comas. Las strings deben estar codificadas como URL, por lo que los puntos de referencia como "Berlín,Alemania|París,Francia" deben convertirse enBerlin%2CGermany%7CParis%2CFrance
.Notas:
- No se admiten los puntos de referencia en todos los productos de Google Maps. En esos casos, se omitirá este parámetro.
- Este parámetro es opcional, a menos que especifiques
waypoint_place_ids
en tu URL. Si decides especificarwaypoint_place_ids
, también debes incluirwaypoints
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 los IDs de lugar para que coincidan con la lista dewaypoints
. Los IDs de lugar deben aparecer en el mismo orden que los puntos de referencia, y deben separarse con el carácter de barra vertical "|
" (codificado con URL como%7C
). Si intentas especificar de forma definitiva algunos establecimientos, los ID de lugar son la mejor opción para vincular a los lugares correctos. Las URL que usan este parámetro también deben incluirwaypoints
.
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 inicia un mapa con instrucciones sobre cómo llegar en bicicleta desde la Aguja Espacial hasta el mercado de Pike Place, en Seattle, Washington.
En el siguiente ejemplo, se inicia un mapa con instrucciones sobre cómo llegar a pie desde Google en Sídney, Australia, hasta el edificio Queen Victoria.
Muestra de un mapa
La acción de mapa muestra un mapa sin marcadores ni instrucciones sobre cómo llegar.
Crea la URL del mapa
https://www.google.com/maps/@?api=1&map_action=map¶meters
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,map_action
debe especificarse comomap
.center
(opcional): Define el centro de la ventana del mapa y acepta las 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 completos que van de 0 (todo el mundo) 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 serroadmap
(predeterminado),satellite
oterrain
.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
obicycling
.
Ejemplos de mapas
Esta URL de ejemplo inicia un mapa de Google predeterminado, 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 los parámetros opcionales zoom
y basemap
.
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 procesa 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. También están disponibles las fotos esféricas aportadas por los usuarios y las colecciones especiales de Street View.
Cómo crear la URL de Street View
https://www.google.com/maps/@?api=1&map_action=pano¶meters
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,action
debe especificarse comopano
.
También se requiere uno de los siguientes parámetros de dirección URL:
viewpoint
: El visor muestra la panorámica que se haya tomado más cerca de la ubicaciónviewpoint
, 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 a que las fotografías pueden tomarse desde posiciones ligeramente diferentes en cada ocasión, es posible que tu ubicación se integre a otra panorámica cuando se actualicen las imágenes.pano
: El ID de panorámica específico de la imagen que se mostrará. Si especificas unapano
, también puedes especificar unaviewpoint
.viewpoint
solo se usa si Google Maps no puede encontrar el ID de panorámica. Si se especificapano
, pero no se encuentra, y no se especifica unviewpoint
, NO se muestra ninguna imagen panorámica. En su lugar, Google Maps se abre en el 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 según la brújula en grados en sentido horario, partiendo del norte. Se aceptan valores comprendidos entre -180 y 360 grados. Si se omite, se elige un encabezado predeterminado según el punto de vista (si se especifica) de la consulta 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 desde -90 hasta 90. Los valores positivos orientarán la cámara en un ángulo ascendente, mientras los valores negativos la orientarán en un ángulo descendente. El valor predeterminado de 0 se establece según la posición de la cámara cuando se capturó la imagen. Debido a esto, una inclinación de 0 a menudo es horizontal, pero no siempre. Por ejemplo, una imagen tomada en una colina posiblemente exhiba una inclinación predeterminada que no es horizontal.fov
: Determina el campo visual horizontal de la imagen. El campo de visión se expresa en grados, con un rango de 10 a 100. El valor predeterminado es 90. Cuando se utiliza un viewport de tamaño fijo, el campo de visión 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 primeros dos ejemplos muestran una panorámica de la Torre Eiffel. En el primer ejemplo, se usa solo un viewpoint
para la ubicación y se establecen los parámetros opcionales heading
, pitch
y fov
. Para la comparación, el ejemplo dos usa un ID de pano
y los mismos parámetros establecidos en el primer ejemplo. En el tercer ejemplo, se muestra una imagen panorámica de interiores.
Ejemplo 1: Usa solo un viewpoint
para especificar la ubicación.
Ejemplo 2: Usa un ID de pano
y una ubicación viewpoint
.
El ID de pano
tiene prioridad sobre el viewpoint
.
En este ejemplo, se encuentra el ID de panorámica, por lo que se ignora el 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 que se encontró solo con viewpoint
.
Ejemplo 3: Muestra una panorámica del interior del restaurante Sarastro en Londres, Reino Unido, especificado 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 usar varios métodos.
- Para JavaScript, usa la clase StreetViewPanorama.
- Para Android, usa la clase pública StreetViewPanoramaLocation.
- En iOS, usa la clase GMSPanorama.
- También puedes realizar solicitudes de metadatos con la API de imagen de Google Street View. Las solicitudes de metadatos de imágenes proporcionan datos sobre las panorámicas de Street View, incluido el ID de panorámica.
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 instrucciones sobre cómo llegar en automóvil desde París, Francia hasta Cherbourg, Francia, y especifican los siguientes puntos de referencia:
Ciudad, país | Nombre del lugar | ID de lugar |
---|---|---|
1. Versalles, Francia | 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 URL de ejemplo, los puntos de referencia se definen de diferentes maneras, de modo 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:
Ejemplo 2: puntos de referencia definidos como nombres de sitios específicos:
Ejemplo 3: puntos de referencia definidos como ciudad y país, y también proporciona waypoint_place_ids
para un establecimiento específico en cada punto de referencia:
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 puntos de referencia en el orden en el que se enumeran en la URL.
Ejemplos de mapas
Muestra un mapa con un basemap
(satélite) y un layer
(transporte) especificados.
Ejemplos de Street View
Muestra una panorámica de Street View con una clave de imagen de FIFE como ID de pano
. Ten en cuenta que el ID de pano
está precedido por F:.