Schéma d'URL Google Maps pour iOS

Sur les appareils équipés d'iOS 9 ou version ultérieure, vous pouvez utiliser les liens universels pour lancer Google Maps lorsque vous disposez d'une URL Google Maps.

Vous pouvez utiliser le schéma d'URL Google Maps pour lancer l'application Google Maps pour iOS et effectuer des recherches, obtenir des requêtes d'itinéraire et afficher des cartes. Lorsque vous lancez Google Maps, votre identifiant de bundle est automatiquement envoyé dans la requête.

Vous n'avez pas besoin d'une clé API Google pour utiliser le schéma d'URL Google Maps.

Remarque:Les URL Maps vous permettent de créer une URL universelle multiplate-forme pour lancer Google Maps et effectuer des recherches, obtenir des itinéraires, afficher des cartes et des images panoramiques. Nous vous recommandons d'utiliser les URL Maps multiplates-formes pour lancer Google Maps, car ces URL universelles permettent de traiter plus largement les requêtes de cartes, quelle que soit la plate-forme utilisée par l'utilisateur. Vous ne devez utiliser le schéma d'URL Maps spécifique à iOS que pour les fonctionnalités susceptibles de ne fonctionner que sur une plate-forme mobile (par exemple, la navigation détaillée).

Liens universels et Google Maps

Google Maps pour iOS prend en charge les liens universels sur les appareils équipés d'iOS 9 ou version ultérieure.

Si votre URL correspond à l'expression régulière suivante et que l'appareil exécute iOS 9 ou une version ultérieure, vous pouvez envisager d'utiliser directement la méthode openURL:.

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

Par exemple :

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"]];

Présentation

Un schéma d'URL vous permet de lancer une application iOS native à partir d'une autre application iOS ou d'une application Web. Vous pouvez définir des options dans l'URL qui sera transmise à l'application lancée. L'application Google Maps pour iOS est compatible avec les schémas d'URL suivants:

• comgooglemaps:// et comgooglemaps-x-callback:// : ces schémas vous permettent de lancer l'application Google Maps pour iOS et d'effectuer l'une des actions suivantes :

  • Afficher une carte à un point géographique et avec un niveau de zoom donnés
  • Recherchez des lieux ou des lieux, et affichez-les sur une carte.
  • Demander un itinéraire d'un endroit à un autre. Un itinéraire peut être renvoyé pour quatre modes de transport: en voiture, à pied, à vélo et en transports en commun.
  • Ajoutez la navigation à votre application.
  • Avec iOS 8, envoyez un rappel lorsque l'application est terminée, à l'aide de comgooglemaps-x-callback://. Les rappels sont souvent utilisés pour renvoyer un utilisateur à l'application qui a initialement ouvert Google Maps pour iOS. Notez que sous iOS 9, le système fournit automatiquement un lien "Retour à" dans l'angle gauche de la barre d'état.

• comgooglemapsurl:// : ce schéma vous permet de lancer l'application Google Maps pour iOS à l'aide d'une URL dérivée du site Web Google Maps pour ordinateur. Cela signifie que vous pouvez offrir à vos utilisateurs une expérience mobile native au lieu de simplement charger le site Web Google Maps.

  • L'URL d'origine peut correspondre à maps.google.com ou google.com/maps, ou utiliser un domaine de pays de premier niveau valide au lieu de com. Vous pouvez également transmettre des URL de redirection goo.gl/maps.
  • Vous pouvez émettre un rappel à l'aide des paramètres x-source et x-success avec le schéma d'URL comgooglemapsurl://.

Lancer l'application Google Maps pour iOS et exécuter une fonction spécifique

Remarque :À partir d'iOS 9, votre application doit déclarer les schémas d'URL qu'elle ouvrira. Pour en savoir plus, consultez la section Premiers pas.

Pour lancer l'application Google Maps pour iOS et éventuellement exécuter l'une des fonctions compatibles, utilisez un schéma d'URL au format suivant:

comgooglemaps://?parameters

ou :

comgooglemaps-x-callback://?parameters

Les paramètres sont décrits en détail ci-après dans le présent document.

Vérifier la disponibilité de l'application Google Maps sur l'appareil

Avant de présenter l'une de ces URL à un utilisateur dans votre application, vous devez d'abord vérifier que l'application est installée. Votre application peut vérifier que le schéma d'URL est disponible à l'aide du code suivant:

Swift

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

Objective-C

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

Par exemple, pour afficher une carte de Central Park à New York, vous pouvez utiliser le code suivant:

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://");
}

Afficher une carte

Utilisez le modèle d'URL pour afficher la carte au niveau de zoom et à la position géographique spécifiés. Vous pouvez également superposer d'autres vues sur votre carte ou afficher des images Street View.

Paramètres

Tous les paramètres suivants sont facultatifs. Si aucun paramètre n'est défini, le schéma d'URL lancera l'application Google Maps pour iOS.

• center: point central de la fenêtre d'affichage de la carte. Formaté en tant que chaîne latitude,longitude séparée par une virgule.
• mapmode: définit le type de carte affiché. Peut être défini sur standard ou streetview. Si aucune valeur n'est spécifiée, les paramètres d'application actuels seront utilisés.
• views : active ou désactive des vues spécifiques. Peut être défini sur satellite, traffic ou transit. Vous pouvez définir plusieurs valeurs à l'aide d'un séparateur de virgules. Si le paramètre est spécifié sans valeur, toutes les vues seront effacées.
• zoom: spécifie le niveau de zoom de la carte.

Cet exemple d'URL affiche la carte centrée sur New York au niveau de zoom 14 avec la vue Trafic sur:

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

Voici quelques exemples supplémentaires:

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

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

Rechercher

Utilisez ce modèle pour afficher des requêtes de recherche pour le point géographique spécifié de la fenêtre d'affichage.

Paramètres

En plus des paramètres utilisés pour afficher une carte, la recherche accepte le paramètre q.

• q: chaîne de requête de votre recherche.

Cet exemple d'URL permet de rechercher "Pizza" autour du lieu spécifié:

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

Voici quelques exemples supplémentaires:

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

Afficher un itinéraire

Utilisez ce modèle pour demander et afficher l'itinéraire entre deux points géographiques. Vous pouvez également préciser le mode de transport.

Paramètres

• saddr: définit le point de départ des recherches d'itinéraire. Il peut s'agir d'une latitude,longitude ou d'une adresse au format de requête. S'il s'agit d'une chaîne de requête qui renvoie plusieurs résultats, le premier est sélectionné. Si vous n'indiquez aucune valeur, la position actuelle de l'utilisateur est utilisée.
• daddr: définit le point d'arrivée des recherches d'itinéraire. Il a le même format et le même comportement que saddr.
• directionsmode: moyen de transport. Peut être défini sur driving, transit, bicycling ou walking.

L'exemple d'URL affiche l'itinéraire en transports en commun entre Google NYC et l'aéroport CDG:

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

Voici quelques exemples supplémentaires:

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

Spécifier une URL de rappel

Si vous souhaitez spécifier une URL de rappel, vous devez utiliser le schéma d'URL comgooglemaps-x-callback://. Ce schéma est conforme à la spécification x-callback-url. Lorsque vous appelez l'application Google Maps pour iOS avec ce schéma, l'application affiche un bouton en haut de l'écran. Lorsque vous appuyez sur ce bouton, un rappel est émis vers une URL que vous avez spécifiée.

Les demandes envoyées à comgooglemaps-x-callback:// doivent respecter le format suivant:

comgooglemaps-x-callback://?parameters

Paramètres

Le schéma d'URL de rappel x accepte les mêmes paramètres que le schéma d'URL comgooglemaps://, avec les paramètres supplémentaires suivants. Ces deux paramètres sont obligatoires.

• x-source : nom de l'application qui envoie la requête de rappel x. Les noms courts sont à privilégier.
• x-success : URL à appeler une fois l'opération terminée. Il s'agit souvent d'un schéma d'URL pour votre propre application, permettant aux utilisateurs de revenir à l'application d'origine.

Notez que votre application doit enregistrer son propre schéma d'URL pour pouvoir répondre à l'URL de rappel.

1. Assurez-vous que votre application a enregistré un schéma d'URL pouvant répondre à la requête de rappel.
2. Transmettez le libellé du bouton de rappel dans le paramètre x-source.
3. Transmettez l'URL de rappel dans le paramètre x-success.

L'exemple suivant lance l'application Google Maps pour iOS et affiche une carte centrée sur New York. L'application affiche également un bouton intitulé "SourceApp". Lorsque vous cliquez sur le bouton "SourceApp", l'application Google Maps pour iOS envoie un rappel à un schéma d'URL fictif, sourceapp://?resume=true.

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

Comme pour le schéma d'URL comgooglemaps://, vous devez d'abord vérifier que l'application Google Maps pour iOS est disponible sur l'appareil et qu'elle est compatible avec le schéma d'URL de rappel x. Votre application peut vérifier que le schéma d'URL est disponible à l'aide du code suivant:

Swift

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

Objective-C

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

Voici un exemple d'URL qui permet aux utilisateurs de revenir à une application après avoir recherché un dessert.

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

Ajouter la navigation à votre application

En lançant l'application Google Maps pour iOS avec une demande d'itinéraire, vous pouvez facilement permettre à vos utilisateurs d'accéder à la navigation détaillée à partir de votre application. Vous pouvez utiliser les schémas d'URL comgooglemaps:// ou comgooglemaps-x-callback://.

Remarque :Les boutons ajoutés via le paramètre x-source ne seront pas affichés dans l'interface utilisateur de la navigation détaillée.

Cet extrait de code montre comment utiliser le schéma comgooglemaps-x-callback:// pour demander un itinéraire, puis revenir à votre application lorsque l'utilisateur est prêt. Le code effectue les opérations suivantes:

1. Vérifiez que le schéma d'URL comgooglemaps-x-callback:// est disponible.
2. Lancez l'application Google Maps pour iOS et demandez un itinéraire vers l'aéroport JFK de New York. Laissez l'adresse de départ vide pour demander un itinéraire à partir de la position actuelle de l'utilisateur.
3. Ajoutez un bouton intitulé "AirApp" à l'application Google Maps pour iOS. Le libellé du bouton est défini par le paramètre x-source.
4. Appelez le schéma d'URL fictif sourceapp:// lorsque l'utilisateur clique sur le bouton "Retour".

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.");
}

Lancer l'application Google Maps pour iOS à partir d'une URL Google Maps pour ordinateur

Si votre application a accès à une URL Google Maps préexistante (sur une page Web ou dans une base de données, par exemple), vous pouvez utiliser ce schéma pour ouvrir l'URL dans l'application Google Maps pour iOS, et offrir ainsi à vos utilisateurs la meilleure expérience native possible.

1. Remplacez le schéma http:// ou https:// par comgooglemapsurl://.
2. Si vous souhaitez utiliser un rappel, incluez les paramètres x-source et x-success. Ce schéma est conforme à la spécification x-callback-url.

Formats d'URL Google Maps acceptés

Le schéma comgooglemapsurl:// accepte les URL qui correspondent à cette expression régulière, où {TLD} fait référence à tout domaine de pays de premier niveau valide. Des sauts de ligne ont été ajoutés pour plus de clarté:

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

Vérifier la disponibilité de l'application Google Maps

Vérifiez d'abord que l'application Google Maps pour iOS est disponible sur l'appareil et qu'elle est compatible avec le schéma d'URL:

Swift

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

Objective-C

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

Exemples

Exemple d'URL Google Maps générique:

URL Google Maps d'origine :

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

Avec le modèle d'URL :

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

Exemple d'URL Google Maps générique:

URL Google Maps d'origine :

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

Avec le modèle d'URL :

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

Exemple de requête d'itinéraire vers la tour de Tokyo avec x-callback:

URL Google Maps d'origine :

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

L'exemple suivant lance l'application Google Maps pour iOS et affiche une carte avec l'itinéraire vers la tour de Tokyo, comme spécifié dans l'URL Google Maps d'origine (ci-dessus). L'application affiche également un bouton intitulé "SourceApp". Lorsque vous cliquez sur le bouton "SourceApp", l'application Google Maps pour iOS envoie un rappel à un schéma d'URL fictif, 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