Aide-mémoire de l'API Maps Embed

L'API Maps Embed place une carte interactive ou un panorama Street View sur une page Web via une requête HTTP définie comme une URL d'iframe src, sans nécessiter de code JavaScript. Il est compatible avec les modes Plan place, view, directions, streetview et search.

API Maps Embed : informations clés

  • Produit : API Maps Embed
  • Également appelée : API Google Maps Embed, Maps Embed
  • Catégorie : Maps
  • Plate-forme : JavaScript (navigateur)
  • Exécution sur : client (code de l'application ou du navigateur)
  • Étape de lancement : GA
  • Cycle de vie : Actif
  • Présentation : Présentation de l'API Maps Embed
  • Disponibilité régionale : monde entier. Le mode Street View dépend de la couverture Street View. Le paramètre region accepte les régions listées sur la page d'informations de la couverture Maps Platform. (détails de la couverture)

API Maps Embed : quand l'utiliser ?

Utilisez l'API Maps Embed dans les cas suivants :

  • Vous avez besoin d'une carte interactive ou d'un panorama Street View sur une page Web, en utilisant uniquement un iFrame HTML, sans JavaScript.
  • Vous devez afficher un repère de lieu, une vue plan, un itinéraire entre des points ou des résultats de recherche pour une zone dans une carte intégrée.
  • Vous avez besoin d'une carte intégrée sans frais par requête, ni limite de RPS ou de requêtes quotidiennes (une clé API est toujours requise).

N'utilisez pas l'API Maps Embed dans les cas suivants :

  • Vous devez personnaliser une carte Web avec vos propres images et contenus. Utilisez plutôt l'API Maps JavaScript.
  • Vous devez étendre une carte intégrée avec des fonctionnalités programmatiques au-delà des paramètres d'URL de l'iFrame. Utilisez plutôt l'API Maps JavaScript.

API Maps Embed : configuration

API Maps Embed : erreurs courantes

  • Problème : Si la page hôte définit une balise Meta referrer sur no-referrer ou same-origin, le navigateur n'envoie pas l'en-tête Referer, et une clé API limitée aux référents HTTP peut rejeter les requêtes d'intégration. Solution : Ajoutez referrerpolicy="strict-origin-when-cross-origin" à l'iFrame pour que le domaine du site soit envoyé à Google. Consultez /maps/documentation/embed/embedding-map.
  • Problème : Les cartes intégrées ne sont pas acceptées si l'une de leurs dimensions est inférieure à 200 px. Correction : Définissez les attributs width et height de l'iframe sur au moins 200 px. Consultez /maps/documentation/embed/embedding-map.
  • Problème : Même si l'utilisation est sans frais, une carte assombrie avec le filigrane "for development purposes only" (à des fins de développement uniquement) s'affiche si la facturation n'est pas activée, si la méthode de facturation n'est pas valide, si une limite quotidienne que vous vous êtes imposée est dépassée ou si la requête ne comporte pas de HTTP referer alors que vous utilisez une clé limitée par un referer. Solution : Activez la facturation avec un mode de paiement valide sur le projet, augmentez ou supprimez toute limite de quota quotidien que vous vous êtes imposée, et assurez-vous que le site référent est envoyé pour les clés limitées par site référent (par exemple, avec referrerpolicy="strict-origin-when-cross-origin" sur l'iframe). Consultez /maps/documentation/embed/error-messages.
  • Problème : pour les requêtes non valides (paramètres incorrects ou manquants, et erreurs de clé API et de quota telles qu'une clé manquante ou non valide, l'API Maps Embed non activée ou une violation de restriction de clé), seul le code d'état HTTP 4xx est signalé dans la console du navigateur, et non un message descriptif. Le texte de l'erreur s'affiche dans l'iframe à la place de la carte. Correction : lisez le texte d'erreur dans l'iframe et le code d'état de la console (400 pour les erreurs de paramètre, 401 pour une clé manquante, 403 pour une clé non valide), puis vérifiez que les paramètres sont valides, que la clé est valide, que l'API Maps Embed est activée et que les restrictions de clé autorisent la requête. Consultez /maps/documentation/embed/error-messages.

Ce que vous pouvez faire avec l'API Maps Embed

Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.

API Maps Embed : itinéraires et routage

API Maps Embed : Maps

API Maps Embed : Places

API Maps Embed : Street View