Aide-mémoire sur les URL Maps

Les URL Maps vous permettent de créer une URL universelle multiplate-forme qui lance Google Maps pour effectuer des recherches, obtenir un itinéraire, utiliser la navigation, afficher des cartes, créer une liste de lieux ou afficher des panoramas Street View. La syntaxe de l'URL est la même sur toutes les plates-formes, et aucune clé API n'est requise.

URL Maps : données clés

  • Produit : URL Maps
  • Également appelées : URL Google Maps
  • Catégorie : Maps
  • Plate-forme : schéma d'URL
  • Étape de lancement : GA
  • Cycle de vie : Actif
  • Présentation : Présentation des URL Maps

URL Maps : quand les utiliser

Utilisez les URL Maps dans les cas suivants :

  • Vous avez besoin d'un lien depuis votre application Android, votre application iOS ou votre site Web qui ouvre Google Maps pour rechercher un lieu ou afficher des résultats de recherche.
  • Vous devez ouvrir Google Maps avec un itinéraire entre des points, éventuellement avec des points de cheminement, un mode de transport ou une navigation détaillée.
  • Vous devez ouvrir Google Maps sur une vue de carte, une liste de lieux ou un panorama Street View sans utiliser de clé API.
  • Vous avez besoin d'une syntaxe d'URL qui fonctionne de la même manière sur Android, iOS et les navigateurs pour ordinateur.

N'utilisez pas d'URL Maps dans les cas suivants :

  • Vous demandez déjà Place Details et souhaitez obtenir des liens Google Maps préformatés pour un lieu (champs googleMapsUri ou googleMapsLinks). Utilisez plutôt l'API Places (nouvelle version).
  • Vous avez besoin de fonctionnalités réservées aux mobiles lorsque vous lancez l'application Google Maps. Utilisez les intents Google Maps pour Android ou le schéma d'URL Google Maps pour iOS.

URL Maps : configuration

  • Attribution de l'utilisation : ajoutez les paramètres de requête facultatifs utm_source (nom de votre application) et utm_campaign (action prévue de l'utilisateur, par exemple place_details_search) aux URL Maps.
  • Premiers pas : Configurer les URL Maps

URL Maps : erreurs courantes

  • Problème : une URL de recherche ne contenant que la latitude et la longitude dans query affiche un repère, mais pas les détails du lieu sur la carte ni dans le panneau latéral. Solution : Utilisez query=PLACE_NAME,ADDRESS ou ajoutez query_place_id à côté de query pour afficher les détails du lieu spécifique. Consultez /maps/documentation/urls/get-started.
  • Problème : Les paramètres d'ID de lieu (query_place_id, origin_place_id, destination_place_id, waypoint_place_ids) ne fonctionnent pas seuls. Correction : incluez toujours le paramètre de base correspondant (query, origin, destination ou waypoints) lorsque vous transmettez un paramètre d'ID de lieu. Consultez /maps/documentation/urls/get-started.
  • Problème : Le paramètre waypoints est ignoré sur les produits Google Maps qui ne sont pas compatibles avec les points de cheminement et qui ont des limites de nombre dépendantes de la plate-forme. Le paramètre dir_action=navigate est ignoré lorsque la navigation n'est pas disponible. Correction : N'utilisez pas plus de trois points de cheminement pour les liens qui s'ouvrent dans les navigateurs mobiles (neuf sinon), et ne comptez pas sur le fonctionnement de waypoints ou dir_action=navigate sur tous les produits ou itinéraires Google Maps. Consultez /maps/documentation/urls/get-started#directions-action.
  • Problème : Maps et Street View partagent le même point de terminaison @. Par conséquent, une URL de carte sans l'action appropriée peut ne pas afficher de carte. Correction : Définissez map_action=map pour les vues de carte et map_action=pano pour les panoramas Street View. Consultez /maps/documentation/urls/get-started.
  • Problème : Si api=1 est manquant dans une URL Maps, tous les paramètres sont ignorés et Google Maps s'ouvre dans sa vue par défaut. Correction : Incluez api=1 dans chaque URL Maps (1 est la seule valeur valide). Consultez /maps/documentation/urls/get-started#forming-the-url.