Esquema de URL de Google Maps para iOS

En dispositivos con iOS 9 y versiones posteriores, puedes usar vínculos universales para iniciar Google Maps cuando tienes una URL de Google Maps.

Puedes usar el esquema de direcciones URL de Google Maps para iniciar la aplicación de Google Maps para iOS y realizar búsquedas, obtener solicitudes de instrucciones sobre cómo llegar y mostrar vistas de mapas. Cuando inicias Google Maps, tu identificador de paquete se envía automáticamente como parte de la solicitud.

No necesitas una clave de API de Google para usar el esquema de URL de Google Maps.

Nota: Las URLs de Maps te permiten crear una URL universal multiplataforma para iniciar Google Maps y realizar búsquedas, obtener instrucciones sobre cómo llegar, mostrar vistas de mapa y mostrar imágenes panorámicas. Te recomendamos que uses las URLs de Maps multiplataforma para iniciar Google Maps, ya que estas URLs universales permiten un control más amplio de las solicitudes de mapas sin importar en qué plataforma esté el usuario. Solo debes usar el esquema de URL de Maps específico para iOS para las funciones que solo pueden funcionar en una plataforma para dispositivos móviles (por ejemplo, la navegación paso a paso).

Vínculos universales y Google Maps

Google Maps para iOS admite vínculos universales en dispositivos que ejecuten iOS 9 o versiones posteriores.

Si tu URL coincide con la siguiente expresión regular y el dispositivo ejecuta iOS 9 o versiones posteriores, te recomendamos que uses el método openURL: directamente.

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

Por ejemplo:

Swift

UIApplication.shared.openURL(URL(string:"https://www.google.com/maps/@42.585444,13.007813,6z")!)

Objective-C

[[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"https://www.google.com/maps/@42.585444,13.007813,6z"]];

Descripción general

Un esquema de URL te permite iniciar una aplicación para iOS nativa desde otra aplicación para iOS o una aplicación web. En la URL, puedes configurar opciones que se pasarán a la aplicación que se inició. La app de Google Maps para iOS admite los siguientes esquemas de direcciones URL:

• comgooglemaps:// y comgooglemaps-x-callback://: Estos esquemas te permiten iniciar la app de Google Maps para iOS y realizar una de las siguientes acciones:

  • Mostrar un mapa en una ubicación y a un nivel de zoom especificados.
  • Buscar ubicaciones o lugares y mostrarlos en un mapa.
  • Solicitar indicaciones para ir de una ubicación a otra. Se pueden proporcionar indicaciones para cuatro modos de transporte: en automóvil, a pie, en bicicleta y en transporte público.
  • Agrega navegación a tu app.
  • A través de iOS 8, al completarse la aplicación, realizar un callback con comgooglemaps-x-callback://. A menudo, los callbacks se usan para que un usuario regrese a la app que abrió originalmente Google Maps para iOS. Ten en cuenta que, en iOS 9, el sistema proporciona automáticamente un vínculo “Volver a” en la esquina izquierda de la barra de estado.

• comgooglemapsurl://: Este esquema te permite iniciar la app de Google Maps para iOS con una URL derivada del sitio web de Google Maps para computadoras de escritorio. Esto significa que puedes brindar a tus usuarios una experiencia móvil nativa en lugar de simplemente cargar el sitio web de Google Maps.

  • La URL original puede usarse para maps.google.com o google.com/maps, o para cualquier dominio de nivel superior de código de país válido en lugar de com. También puedes pasar URLs de redireccionamiento de goo.gl/maps.
  • Puedes realizar una devolución de llamada con los parámetros x-source y x-success con el esquema de URL comgooglemapsurl://.

Iniciar la app de Google Maps para iOS y realizar una función específica

Nota: A partir de iOS 9, tu app debe declarar los esquemas de URL que abrirá. Consulta Cómo comenzar para obtener más información.

Para iniciar la app de Google Maps para iOS y, de manera opcional, realizar una de las funciones compatibles, usa un esquema de URL con el siguiente formato:

comgooglemaps://?parameters

o:

comgooglemaps-x-callback://?parameters

Más adelante, en este documento, se ofrece una descripción detallada de los parámetros.

Cómo verificar la disponibilidad de la app de Google Maps en el dispositivo

Antes de presentar una de estas URLs a un usuario en tu aplicación, primero debes verificar que se instale una aplicación. Tu app puede verificar que el esquema de direcciones URL esté disponible con el siguiente código:

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
    [NSURL URLWithString:@"comgooglemaps://"]];

Por ejemplo, para mostrar un mapa del Central Park de Nueva York, puedes usar el siguiente código:

Swift

if (UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)) {
  UIApplication.shared.openURL(URL(string:
    "comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic")!)
} else {
  print("Can't use comgooglemaps://");
}

Objective-C

if ([[UIApplication sharedApplication] canOpenURL:
     [NSURL URLWithString:@"comgooglemaps://"]]) {
  [[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic"]];
} else {
  NSLog(@"Can't use comgooglemaps://");
}

Muestra de un mapa

Usa el esquema de direcciones URL para mostrar el mapa en una ubicación y a un nivel de zoom especificados. También puedes superponer otras vistas en tu mapa o mostrar imágenes de Street View.

Parámetros

Todos los parámetros siguientes son opcionales. Si no hay parámetros configurados, el esquema de direcciones URL iniciará la app de Google Maps para iOS.

• center: Es el punto central de la vista del mapa. Su formato consiste en una cadena de latitude,longitude separada por comas.
• mapmode: Establece el tipo de mapa que se muestra. Se puede configurar en: standard o streetview. Si no se especifica, se usará la configuración actual de la aplicación.
• views: Activa o desactiva vistas específicas. Se puede configurar como satellite, traffic o transit. Se pueden configurar varios valores usando un separador de coma. Si no se usan valores para especificar el parámetro, se borrarán todas las vistas.
• zoom: Especifica el nivel de zoom del mapa.

En esta URL de ejemplo, se muestra el mapa centrado en Nueva York con un zoom de 14 y la vista de tráfico activa:

comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic

Estos son algunos ejemplos adicionales:

comgooglemaps://?center=37.788463,-122.392545&zoom=12

comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

Buscar

Usa este esquema para mostrar solicitudes de búsqueda dentro de una ubicación de viewport especificada.

Parámetros

Además de los parámetros que se usan para mostrar un mapa, la búsqueda admite el parámetro q.

• q: Es la cadena de consulta de tu búsqueda.

Esta es una URL de ejemplo para buscar “Pizza” en la ubicación especificada:

comgooglemaps://?q=Pizza&center=37.759748,-122.427135

Estos son algunos ejemplos adicionales:

comgooglemaps://?q=Steamers+Lane+Santa+Cruz,+CA&center=37.782652,-122.410126&views=satellite,traffic&zoom=15

comgooglemaps://?q=Google+Japan,+Minato,+Tokyo,+Japan&center=35.660888,139.73073&zoom=15&views=transit

Cómo mostrar instrucciones sobre cómo llegar

Usa el esquema siguiente para solicitar y mostrar indicaciones que conecten dos ubicaciones. También puedes especificar el modo de transporte.

Parámetros

• saddr: Establece el punto de partida para búsquedas de instrucciones sobre cómo llegar. Puede ser una latitud y longitud o una dirección con formato de consulta. Si es una cadena de consulta que devuelve más de un resultado, se seleccionará el primer resultado. Si el valor se deja en blanco, se usará la ubicación actual del usuario.
• daddr: Establece el punto de llegada para las búsquedas de instrucciones sobre cómo llegar. Tiene el mismo formato y comportamiento que saddr.
• directionsmode: Es el medio de transporte. Se puede establecer en driving, transit, bicycling o walking.

La URL de ejemplo muestra instrucciones sobre cómo llegar en transporte público entre Google NYC y el Aeropuerto JFK:

comgooglemaps://?saddr=Google+Inc,+8th+Avenue,+New+York,+NY&daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York&directionsmode=transit

Estos son algunos ejemplos adicionales:

comgooglemaps://?saddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA+94043&daddr=Google+Inc,+345+Spear+Street,+San+Francisco,+CA&center=37.422185,-122.083898&zoom=10

comgooglemaps://?saddr=2025+Garcia+Ave,+Mountain+View,+CA,+USA&daddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA,+United+States&center=37.423725,-122.0877&directionsmode=walking&zoom=17

Especifica una URL de devolución de llamada

Si deseas especificar una URL de devolución de llamada, deberás usar el esquema de URL comgooglemaps-x-callback://. Este esquema cumple con la especificación “x-callback-url”. Cuando llames a la app de Google Maps para iOS con este esquema, la app mostrará un botón en la parte superior de la pantalla. Al tocar este botón, se realizará un callback para una URL que hayas especificado.

Las solicitudes a comgooglemaps-x-callback:// deben tener el siguiente formato:

comgooglemaps-x-callback://?parameters

Parámetros

El esquema de direcciones URL “x-callback” acepta los mismos parámetros que el esquema de direcciones URL comgooglemaps://, con los parámetros adicionales siguientes. Ambos parámetros son obligatorios.

• x-source: Es el nombre de la aplicación que envía la solicitud de devolución de llamada. Se prefieren los nombres cortos.
• x-success: Es la URL a la que se debe llamar cuando se complete. A menudo, será un esquema de URL para tu propia app, lo cual permitirá que los usuarios regresen a la aplicación original.

Ten en cuenta que tu app deberá registrar su propio esquema de URL para poder responder a la URL de devolución de llamada.

1. Asegúrate de que tu aplicación haya registrado un esquema de URL que pueda responder a la solicitud de devolución de llamada.
2. Pasa la etiqueta del botón de devolución de llamada en el parámetro x-source.
3. Pasa la URL de devolución de llamada en el parámetro x-success.

Con el siguiente ejemplo, se iniciará la app de Google Maps para iOS y se mostrará un mapa centrado en Nueva York. En la aplicación también se mostrará un botón con la etiqueta "SourceApp". Cuando se haga clic en el botón “SourceApp”, la app de Google Maps para iOS emitirá un callback para un esquema de URL ficticio, sourceapp://?resume=true.

comgooglemaps-x-callback://?center=40.765819,-73.975866&zoom=14
   &x-success=sourceapp://?resume=true
   &x-source=SourceApp

Como en el caso del esquema de direcciones URL comgooglemaps://, primero debes verificar que la app de Google Maps para iOS esté disponible en el dispositivo y admita el esquema de direcciones URL “x-callback”. Tu app puede verificar que el esquema de direcciones URL esté disponible con el siguiente código:

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemaps-x-callback://"]];

Este es un ejemplo de una URL que permite a los usuarios regresar a una app después de realizar búsquedas de postre.

comgooglemaps-x-callback://?q=dessert&center=37.759748,-122.427135
   &x-success=sourceapp://?resume=true
   &x-source=Nom+Nom

Cómo agregar navegación a tu app

El lanzamiento de la app de Google Maps para iOS con una solicitud de indicaciones es una forma fácil de ofrecerles a los usuarios acceso a navegación paso a paso desde tu app. Puedes usar los esquemas de URL comgooglemaps:// o comgooglemaps-x-callback://.

Nota: Los botones agregados a través del parámetro x-source no se mostrarán en la IU de navegación paso a paso.

En este fragmento de código, se muestra cómo usar el esquema comgooglemaps-x-callback:// para solicitar instrucciones y, luego, regresar a tu app cuando el usuario esté listo. El código hará lo siguiente:

1. Verifica que el esquema de URL comgooglemaps-x-callback:// esté disponible.
2. Iniciar la aplicación de Google Maps para iOS y solicitar indicaciones para llegar al Aeropuerto JFK de la ciudad de Nueva York Dejar la dirección de partida en blanco para solicitar indicaciones a partir de la ubicación actual del usuario
3. Agregar un botón con la etiqueta “AirApp” a la app de Google Maps para iOS El parámetro x-source define la etiqueta del botón.
4. Llama al esquema de URL ficticio, sourceapp://, cuando los usuarios hagan clic en el botón de retroceso.

Swift

let testURL = URL(string: "comgooglemaps-x-callback://")!
if UIApplication.shared.canOpenURL(testURL) {
  let directionsRequest = "comgooglemaps-x-callback://" +
    "?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
    "&x-success=sourceapp://?resume=true&x-source=AirApp"

  let directionsURL = URL(string: directionsRequest)!
  UIApplication.shared.openURL(directionsURL)
} else {
  NSLog("Can't use comgooglemaps-x-callback:// on this device.")
}

Objective-C

NSURL *testURL = [NSURL URLWithString:@"comgooglemaps-x-callback://"];
if ([[UIApplication sharedApplication] canOpenURL:testURL]) {
  NSString *directionsRequest = @"comgooglemaps-x-callback://" +
      @"?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
      @"&x-success=sourceapp://?resume=true&x-source=AirApp";
  NSURL *directionsURL = [NSURL URLWithString:directionsRequest];
  [[UIApplication sharedApplication] openURL:directionsURL];
} else {
  NSLog(@"Can't use comgooglemaps-x-callback:// on this device.");
}

Cómo iniciar la app de Google Maps para iOS desde una URL de escritorio de Google Maps

Si tu app tiene acceso a una URL de Google Maps preexistente, como en una página web o una base de datos, puedes usar este esquema para abrir la URL en la app de Google Maps para iOS. Con esto, brindarás a tus usuarios la mejor experiencia nativa.

1. Reemplaza el esquema http:// o https:// por comgooglemapsurl://.
2. Si deseas usar un callback, incluye los parámetros x-source y x-success. Este esquema cumple con la especificación “x-callback-url”.

Formatos de URL de Google Maps admitidos

El esquema comgooglemapsurl:// admite URLs que coincidan con esta expresión regular, en la que {TLD} hace referencia a cualquier dominio de país de nivel superior válido. Se agregan saltos de línea para brindar mayor claridad:

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

Verifica la disponibilidad de la app de Google Maps

Primero debes verificar que la aplicación de Google Maps para iOS se encuentre disponible en el dispositivo y admita el esquema de direcciones URL:

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemapsurl://"]];

Ejemplos

Ejemplo de una URL genérica de Google Maps:

URL original de Google Maps:

https://www.google.com/maps/preview/@42.585444,13.007813,6z

Uso del esquema de direcciones URL:

comgooglemapsurl://www.google.com/maps/preview/@42.585444,13.007813,6z

Ejemplo de una URL genérica de Google Maps:

URL original de Google Maps:

https://maps.google.com/?q=@37.3161,-122.1836

Uso del esquema de direcciones URL:

comgooglemapsurl://maps.google.com/?q=@37.3161,-122.1836

Ejemplo de solicitud de indicaciones para llegar a la Torre de Tokio con un “x-callback”:

URL original de Google Maps:

http://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1

Con el siguiente ejemplo, se iniciará la app de Google Maps para iOS y se mostrará un mapa con indicaciones para llegar a la Torre de Tokio, según lo especificado en la URL original de Google Maps (arriba). En la aplicación también se mostrará un botón con la etiqueta “SourceApp”. Cuando se hace clic en el botón “SourceApp”, la app de Google Maps para iOS emitirá un callback para un esquema de URL ficticio, sourceapp://?resume=true.

comgooglemapsurl://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1
    &x-source=SourceApp
    &x-success=sourceapp://?resume=true