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
googleMapsUriougoogleMapsLinks). 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) etutm_campaign(action prévue de l'utilisateur, par exempleplace_details_search) aux URL Maps. - Premiers pas : Configurer les URL Maps
URL Maps : produits associés
- Souvent utilisé avec : l'API Places (nouvelle version)
URL Maps : erreurs courantes
- Problème : une URL de recherche ne contenant que la latitude et la longitude dans
queryaffiche un repère, mais pas les détails du lieu sur la carte ni dans le panneau latéral. Solution : Utilisezquery=PLACE_NAME,ADDRESSou ajoutezquery_place_idà côté dequerypour 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,destinationouwaypoints) lorsque vous transmettez un paramètre d'ID de lieu. Consultez /maps/documentation/urls/get-started. - Problème : Le paramètre
waypointsest 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ètredir_action=navigateest 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 dewaypointsoudir_action=navigatesur 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éfinissezmap_action=mappour les vues de carte etmap_action=panopour les panoramas Street View. Consultez /maps/documentation/urls/get-started. - Problème : Si
api=1est manquant dans une URL Maps, tous les paramètres sont ignorés et Google Maps s'ouvre dans sa vue par défaut. Correction : Incluezapi=1dans chaque URL Maps (1est la seule valeur valide). Consultez /maps/documentation/urls/get-started#forming-the-url.