Schéma d'URL Google Maps pour iOS

Sur les appareils équipés d'iOS 9 ou version ultérieure, vous pouvez utiliser des 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 le Google Maps app pour iOS et effectuer des recherches, obtenir des demandes d'itinéraire et afficher des cartes. Lorsque vous lancez Google Maps, votre identifiant de bundle est automatiquement envoyé dans le cadre de la requête.

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

Google Maps pour iOS est compatible avec 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 est équipé d'iOS 9 ou 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 à partir d'une autre application iOS ou d'une application Web. Vous pouvez définir des options dans l'URL qui sont transmises à l'application lancée. L'application Google Maps pour iOS est compatible avec les modèles d'URL suivants :

  • comgooglemaps:// : ce modèle vous permet de lancer l'application Google Maps pour iOS et d'effectuer l'une des actions suivantes :

    • Afficher une carte à un emplacement géographique et avec un niveau de zoom spécifiés.
    • Rechercher des lieux ou des emplacements et les afficher sur une carte.
    • Demander un itinéraire d'un point géographique à un autre. Les itinéraires peuvent être renvoyés pour quatre modes de transport : voiture, marche, vélo et transports en commun.
    • Ajouter la navigation à votre application.

  • comgooglemapsurl:// : ce modèle 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 plutôt que de charger le site Web Google Maps.

    • L'URL d'origine peut être pour maps.google.com, ou pour google.com/maps, ou en utilisant n'importe quel domaine de premier niveau de pays valide au lieu de com. Vous pouvez également transmettre des URL de redirection goo.gl/maps.

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

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

comgooglemaps://?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 modèle d'URL est disponible avec le 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 schéma 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 lance l'application Google Maps pour iOS.

  • center : il s'agit du point central de la fenêtre d'affichage de la carte. Il est mis en forme sous la forme d'une 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 actuels de l'application sont utilisés.
  • views: active ou désactive des vues spécifiques. Peut être défini sur satellite, traffic ou transit. Plusieurs valeurs peuvent être définies à l'aide d'un séparateur de virgules. Si le paramètre est spécifié sans valeur, toutes les vues sont effacées.
  • zoom : spécifie le niveau de zoom de la carte.

L'exemple d'URL suivant affiche la carte centrée sur New York avec un zoom de 14 et la vue du trafic activée :

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

Carte du trafic à New York

Voici quelques exemples supplémentaires :

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

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

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 est compatible avec le paramètre q.

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

L'exemple d'URL suivant recherche "Pizza" autour de l'emplacement spécifié :

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

Pizzas à proximité

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 adresse au format latitude,longitude ou d'une requête. S'il s'agit d'une chaîne de requête qui renvoie plusieurs résultats, le premier résultat est sélectionné. Si la valeur est laissée vide, l'emplacement actuel de l'utilisateur est utilisé.
  • 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 : mode de transport. Peut être défini sur driving, transit, bicycling ou walking.

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

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

Itinéraire en transports en commun

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

Ajouter la navigation à votre application

Le lancement de l'application Google Maps pour iOS avec une demande d'itinéraire permet à vos utilisateurs d'accéder à la navigation détaillée depuis votre application. Vous pouvez utiliser le schéma d'URL comgooglemaps://.

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, par exemple sur une page Web ou dans une base de données, vous pouvez utiliser ce modèle pour ouvrir l'URL dans l'application Google Maps pour iOS, offrant ainsi à vos utilisateurs la meilleure expérience mobile.

  • Remplacez le modèle http:// ou https:// par comgooglemapsurl://.

Formats d'URL Google Maps compatibles

Le modèle comgooglemapsurl:// est compatible avec les URL qui correspondent à cette expression régulière, où {TLD} fait référence à n'importe quel domaine de premier niveau de pays valide. Les sauts de ligne sont 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 modèle d'URL :

Swift

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

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 schéma 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 schéma d'URL :

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