Ancrage avec Google Maps dans Gemini Enterprise Agent Platform

Cette page explique comment l'ancrage avec Google Maps avec Gemini Enterprise Agent Platform peut vous aider à améliorer vos applications d'IA générative en fournissant un contexte géospatial.

Présentation

L'ancrage avec Google Maps avec Gemini Enterprise Agent Platform est un service qui permet d'associer les modèles Gemini aux données géospatiales de Google Maps. Google Maps a accès à des informations sur des millions de lieux, y compris des établissements, des monuments et des points d'intérêt. Ces données vous donnent accès à des informations sur plus de 250 millions de lieux qui peuvent être utilisées pour ancrer les réponses de votre modèle, ce qui permet à vos applications et agents d'IA de fournir des données locales et un contexte géospatial.

Vous pouvez également activer l'ancrage simultané avec Google Maps, la recherche Google et vos sources de données.

Utilisations de l'ancrage avec Google Maps

Vous pouvez utiliser l'ancrage avec Google Maps pour diverses applications, par exemple :

  • Assistants conversationnels capables de répondre à des questions sur les lieux à proximité, comme "Où puis-je trouver un expresso italien ?"
  • des descriptions personnalisées et des informations de la communauté, par exemple "Peux-tu me parler des restaurants adaptés aux familles qui se trouvent à distance de marche ?".
  • Résumés des zones autour d'emplacements spécifiques, comme une borne de recharge VE ou un hôtel.

Cela peut être utile pour les cas d'utilisation dans les applications d'immobilier, de voyage, de mobilité et de réseaux sociaux.

Modèles compatibles

Cette section liste les modèles compatibles avec l'ancrage avec Google Maps.

Cliquez pour développer la liste des modèles compatibles

Pour en savoir plus sur les modèles Gemini, consultez Modèles Gemini.

Utiliser l'ancrage avec Google Maps pour ancrer les réponses de votre modèle

Cet exemple de code montre comment utiliser l'ancrage avec Google Maps pour ancrer les réponses de votre modèle.

Vous pouvez personnaliser les résultats de recherche pour un emplacement géographique spécifique en utilisant les coordonnées de latitude et de longitude.

Console

Pour utiliser l'ancrage avec Google Maps avec Gemini Enterprise Agent Platform, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Agent Studio.

    Accéder à Agent Studio

  2. Dans le panneau latéral, sous Paramètres du modèle, accédez à la section Ancrage, puis cliquez sur l'icône de modification pour Recherche Google, Google Maps. Un volet de configuration s'affiche.

  3. Activez l'option Google Maps.

  4. Cliquez sur Appliquer.

  5. Saisissez votre prompt dans le champ, puis cliquez sur Envoyer. Les réponses données à vos requêtes sont basées sur Google Maps.

Python

Installer

pip install --upgrade google-genai

Pour en savoir plus, consultez la documentation de référence du SDK.

Définissez des variables d'environnement pour utiliser le SDK Google Gen AI avec Vertex AI : 

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True
 

from google import genai
from google.genai.types import (
    GenerateContentConfig,
    GoogleMaps,
    HttpOptions,
    Tool,
)

client = genai.Client(http_options=HttpOptions(api_version="v1"))

response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="Where can I get the best espresso near me?",
    config=GenerateContentConfig(
        tools=[
            # Use Google Maps Tool
            Tool(google_maps=GoogleMaps())
        ],
        tool_config=types.ToolConfig(
            retrieval_config = types.RetrievalConfig(
                lat_lng = types.LatLng( # Pass geo coordinates for location-aware grounding
                    latitude=40.7128,
                    longitude=-74.006
                ),
                language_code = "en_US", # Optional: localize Maps results
            ),
        ),
    ),
)

print(response.text)
# Example response:
# 'Here are some of the top-rated places to get espresso near you: ...'

REST

Avant d'utiliser des données de requête, effectuez les remplacements suivants :

  • LOCATION : région dans laquelle traiter la requête. Pour utiliser le point de terminaison global, excluez l'emplacement du nom du point de terminaison et configurez l'emplacement de la ressource sur "global".
  • PROJECT_ID : l'ID de votre projet. .
  • MODEL_ID : l'ID du modèle multimodal.
  • PROMPT : prompt à envoyer au modèle.
  • LATITUDE : latitude de l'emplacement. Par exemple, une latitude de 37.7749 représente San Francisco. Vous pouvez obtenir des coordonnées de latitude et de longitude à l'aide de services tels que Google Maps ou d'autres outils de géocodage.
  • LONGITUDE : longitude de l'emplacement. Par exemple, une longitude de -122.4194 représente San Francisco.
  • GROUNDING_TYPES : types d'ancrage Google Maps à activer. Actuellement compatible avec places et routing.
    • places : recherchez des informations sur des lieux, y compris des établissements, des points d'intérêt importants et des emplacements géographiques.
    • routing : rechercher un itinéraire et effectuer une recherche le long de l'itinéraire.
    Si aucune valeur n'est spécifiée, la valeur par défaut est places uniquement.

Méthode HTTP et URL : 

POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent

Corps JSON de la requête :

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "PROMPT"
    }]
  }],
  "tools": [{
    "googleMaps": {
      "groundingTypes": {
        "places": {},
        "routing": {}
      }
    }
  }],
  "toolConfig": {
    "retrievalConfig": {
      "latLng": {
        "latitude": LATITUDE,
        "longitude": LONGITUDE
      },
      "languageCode": "en_US"
    }
  },
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout. It has a rating of 4.2 stars based on 411 reviews."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "groundingChunks": [
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=9001322937822692826",
              "title": "The Italian Place",
              "placeId": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w"
            }
          },
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=9001322937822692826",
              "title": "Hank's Pasta Bar",
              "placeId": "places/MMVtPzn9FGcevML89",
              "placeAnswerSources": {
                "reviewSnippets": [
                  {
                    "id": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w",
                    "title": "Google Maps Review",
                    "uri": "https://maps.google.com/?cid=9001322937822692826"
                  },
                ]
              }
            }
          },
          ...
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 79,
              "text": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout."
            },
            "groundingChunkIndices": [
              0
            ]
          },
        ],
      }
    }
  ],
  ...
}

Propriétés du lieu

Cette section liste les propriétés de lieu utilisées pour décrire les lieux et par l'ancrage avec Google Maps pour générer des réponses. Ces propriétés permettent de déterminer les types de questions auxquelles l'Ancrage avec Google Maps peut répondre.

Exemples de propriétés de lieux

Cette liste fournit un échantillon alphabétique de propriétés sur les lieux que votre modèle peut utiliser pour générer des réponses :

  • Adresse
  • Tendances d'affluence
  • Drive disponible
  • Carte de débit
  • Distance
  • Informations sur les bornes de recharge VE (types de connecteurs, vitesses de recharge et disponibilité)
  • Parking gratuit
  • Prix des carburants et types de carburant disponibles
  • Convient aux enfants
  • Concerts
  • Au menu
  • Horaires d'ouverture
  • Modes de paiement (espèces ou carte de crédit, par exemple)
  • Accepte les animaux
  • Examiner les insights
  • Bière
  • Sert des plats végétariens
  • Accessible en fauteuil roulant
  • Wi-Fi

Exemples d'utilisation des propriétés de lieu

Les exemples suivants utilisent des propriétés de lieu dans des questions sur différents types de lieux. L'ancrage avec Google Maps utilise les propriétés pour comprendre votre intention, puis fournit des réponses pertinentes en fonction des données associées aux lieux dans Google Maps.

  • Planifier un dîner en famille : vous pouvez demander "Est-ce que le restaurant "The Italian Place" est adapté aux enfants et propose des plats à emporter ?" Quelle est sa note ?

    Les réponses à ces questions vous aident à déterminer si un restaurant convient à une famille et s'il propose un service pratique.

  • Découvrez les plats phares et les spécialités du menu : vous pouvez demander Quels sont les plats de pâtes les plus recommandés au menu de "The Italian Place" ? Propose-t-il des plats végétariens ? Que disent les avis sur sa sauce marinara ?

    Les réponses à ces questions utilisent les Points forts du menu et les Insights sur les avis pour vous aider à découvrir des offres culinaires spécifiques et les plats préférés de la communauté.

  • Vérifier l'accessibilité pour un ami : vous pouvez demander J'ai besoin d'un restaurant avec une entrée accessible en fauteuil roulant.

    Une réponse à cette question peut vous aider à déterminer si l'établissement répond à des besoins d'accessibilité spécifiques.

  • Trouver un endroit où manger tard le soir : vous pouvez demander "Est-ce que le restaurant Burger Joint est ouvert ?" Proposent-ils un dîner ? Quels sont leurs horaires d'ouverture le vendredi ?

    Les réponses à ces questions vous aident à trouver un établissement ouvert servant un repas spécifique à une heure précise.

  • Planifier la recharge d'un véhicule électrique et les services d'un hôtel pour un road trip : vous pouvez demander Je séjourne au "Overnight Motel". Ont-ils des bornes de recharge VE sur place ? Quels types de connecteurs sont compatibles ? Et à quel point leur parking est-il fréquenté le vendredi soir ?

    Les réponses à ces questions combinent les informations sur les bornes de recharge VE et les tendances d'affluence pour vous aider à planifier la recharge de votre véhicule et à évaluer l'affluence pendant votre séjour.

  • Comparer les prix de l'essence et des carburants spéciaux à proximité : vous pouvez demander Quelles stations-service près de Mountain View, en Californie, vendent du diesel ou de l'hydrogène, et comment leurs prix actuels se comparent-ils ?

    Les réponses à ces questions s'appuient sur les prix du carburant et les types de carburant disponibles pour vous aider à trouver des carburants spéciaux et des stations-service économiques.

  • Synthétiser l'ambiance de travail à partir des avis : vous pouvez demander Que disent les résumés des avis clients sur le niveau de bruit, le confort des sièges et la fiabilité du Wi-Fi au "Breakfast Cafe" pour le télétravail ?

    Une réponse à cette requête s'appuie sur les insights sur les avis pour évaluer si un café est adapté au travail ou aux études en fonction du consensus de la communauté.

Les informations contenues dans les Résultats ancrés Google Maps peuvent différer des conditions réelles de la route ou du lieu.

Comprendre votre réponse

Les sources Google Maps sont renvoyées dans groundingMetadata dans groundingChunks. Les sources sont renvoyées pour les lieux et sont utilisées pour générer les Résultats ancrés Google Maps. Le champ uri peut renvoyer vers un avis ou directement vers la fiche du lieu sur Google Maps.

Cet exemple de code illustre une source de lieu dans la réponse :

"groundingChunks": [
  {
    "maps": {
      "uri": "{Link to place sheet or review on Maps}",
      "title": "{Name of Maps Place}",
      "placeId": "{Place ID}"
    }
  }
],

Routage : trouver un itinéraire

L'ancrage avec Google Maps est compatible avec la fonctionnalité Trouver un itinéraire. Cette fonctionnalité permet à vos agents IA de comprendre les mouvements physiques, les estimations de trajet en temps réel et les relations spatiales entre les lieux. Grâce à la fonctionnalité "Rechercher un itinéraire", votre modèle peut fournir des itinéraires optimisés pour les performances et des temps de trajet précis qui tiennent compte des conditions en temps réel. Cette intégration permet à l'ancrage avec Google Maps de filtrer les lieux en fonction du temps de trajet, de proposer des itinéraires point à point précis et de calculer les temps de trajet estimés pour des modes de transport spécifiques.

Capacités

Find Directions calcule les distances et les durées de trajet précises entre les points de départ et les destinations.

"Rechercher un itinéraire" accepte les éléments suivants :

  • Modes de transport : calcul d'itinéraire en voiture, à pied, à vélo, en transports en commun et en deux-roues motorisés (tous les modes de transport ne sont pas disponibles dans tous les pays)

  • Plusieurs points de cheminement : jusqu'à 13 arrêts intermédiaires entre le point de départ et la destination

  • Trafic en temps réel : prise en compte des conditions de circulation actuelles pour fournir des temps de trajet précis "en direct" plutôt que des moyennes statiques.

Voici des exemples de questions que vous pouvez poser à la fonctionnalité Trouver un itinéraire :

  • Proximité basée sur le temps de trajet : "Quels sont les restaurants américains situés à moins de 10 minutes à pied de l'hôtel Hilton, au 1335 6th Ave à New York ?"

  • Estimation du temps de trajet : "Combien de temps faut-il pour aller de Pike Place Market à Capitol Hill à Seattle en transports en commun ?"

Activer "Trouver un itinéraire"

Dans l'API REST et les SDK, l'ancrage avec Google Maps utilise par défaut les données Places uniquement lorsque grounding_types est omis. Pour activer les fonctionnalités d'itinéraire, vous devez configurer explicitement routing dans grounding_types dans la configuration de votre requête. Si vous souhaitez utiliser à la fois les outils Places et Routing, vous devez spécifier places et routing dans grounding_types.

Comprendre la réponse

Lorsqu'une requête déclenche la fonctionnalité Trouver un itinéraire, le modèle génère une réponse en langage naturel appuyée par des métadonnées structurées. Cela vous permet d'afficher des informations de voyage précises pour l'utilisateur.

Les données suivantes sont renvoyées dans une réponse de charge utile :

  • Durée : temps nécessaire pour se déplacer entre deux lieux, en tenant compte du trafic si demandé. Par exemple, "500 secondes".

  • Distance : distance physique de l'itinéraire. Exemple : "1,9 km".

  • Polyligne : chaîne de texte encodée qui vous permet d'afficher visuellement le chemin d'itinéraire spécifique sur une carte.

Voici un exemple de réponse à la requête "Comment me rendre au restaurant Carmine's depuis l'hôtel Hilton (1335 6th Ave à New York) où je séjourne ?" :

Pour vous rendre au restaurant Carmine's depuis l'hôtel Hilton situé au 1335 6th Ave à New York, vous devez vous rendre au Carmine's - Times Square situé au 200 W 44th St, New York, NY 10036, États-Unis.

Voici l'itinéraire à pied :

  1. Commencez à l'hôtel Hilton : sortez de l'hôtel Hilton au 1335 6th Ave.

  2. Marchez vers le sud sur la 6th Avenue : dirigez-vous vers le sud sur la 6th Avenue (Avenue of the Americas) en direction de la W 44th Street.

  3. Tourner à droite sur W 44th Street : tournez à droite sur W 44th Street.

  4. Carmine's se trouve sur votre gauche : descendez W 44th Street, et Carmine's se trouvera sur votre gauche au 200 W 44th St.

Cette promenade d'environ 800 mètres devrait prendre 10 à 15 minutes.

Voici un exemple de réponse à la requête "Combien de temps faut-il pour aller de Pike Place Market à Capitol Hill en transports en commun à Seattle ?".

Pour vous rendre du marché de Pike Place à Capitol Hill à Seattle en transports en commun, vous avez plusieurs options :

  • Tramway (métro léger) : le trajet en tramway de Westlake, qui se trouve près du marché de Pike Place, à Capitol Hill dure environ trois minutes. En incluant les correspondances, le temps de trajet total est d'environ 9 minutes, avec des trams toutes les 10 minutes.

  • Bus : un bus direct King County Metro relie Pike St & 4th Ave (près de Pike Place Market) à Capitol Hill en 11 minutes environ, avec des départs toutes les 20 minutes. Vous pouvez également prendre la ligne 49, qui met environ 16 minutes.

Routage – Recherche sur l'itinéraire

La recherche le long de l'itinéraire permet à vos agents d'IA de découvrir des points d'intérêt géographiquement pertinents et pratiques pour le trajet prévu par un utilisateur. En ancrant les réponses dans les moteurs de recherche spatiale et d'itinéraires de Google Maps, votre modèle peut fournir des recommandations qui minimisent les détours et comprendre le flux logistique d'un road trip ou d'un trajet domicile-travail.

Capacités

La recherche sur le trajet permet à votre application d'identifier des établissements, des équipements ou des attractions spécifiques situés directement sur un itinéraire généré entre une origine et une destination. Seul le mode de déplacement "Voiture" est accepté.

Les exemples suivants illustrent les types de questions que l'outil Rechercher le long du trajet peut traiter.

  • Recherche d'itinéraire de base : "Trouve des stations-service sur le trajet entre le 1800 Amphitheatre Parkway, Mountain View, CA 94045, États-Unis et le 456 Sunny St, Sunnyvale, CA, États-Unis." (En général, les adresses d'origine et de destination sont issues de l'historique des discussions.)
  • Rechercher en fonction des propriétés d'un lieu : "Y a-t-il des boulangeries avec une note d'au moins 4 étoiles entre San Francisco et 1800 Amphibious Blvd, Mountain View, CA 94045 ?"
  • Recherche d'itinéraire à étapes multiples : "Je pars en road trip de San Francisco à San Luis Obispo, puis à Los Angeles. Suggère-moi trois bornes de recharge pour véhicules électriques entre San Francisco et San Luis Obispo, puis entre San Luis Obispo et Los Angeles."

Activer la recherche sur l'itinéraire

La fonctionnalité Rechercher sur le trajet nécessite les fonctionnalités Places et Routing pour découvrir des lieux situés sur un itinéraire. Dans l'API REST et les SDK, vous devez configurer explicitement places et routing dans grounding_types dans la configuration de votre requête.

Comprendre la réponse

Lorsqu'un prompt déclenche l'outil de recherche le long d'un itinéraire, le modèle génère une réponse en langage naturel basée sur des métadonnées structurées qui combinent les données de Places et de Routing. Cela permet de s'assurer que les lieux suggérés sont réellement pratiques par rapport à l'itinéraire physique. groundingMetadata contiendra groundingChunks pour les lieux renvoyés et l'itinéraire recherché.

Exemple de requête [Recherche d'itinéraire de base] :

Trouve des stations-service sur le trajet entre le 1800 Amphibious Blvd. Mountain View, CA 94045 et le 456 Sunny St, Sunnyvale CA.

Exemple de réponse [Recherche d'itinéraire de base] :

Voici quelques stations-service sur le trajet entre 1800 Amphibious Blvd, Mountain View, CA 94045 et 456 Sunny St, Sunnyvale, CA :

  • Exemple de station-service : située au 123 Example Rd, Sunnyvale, CA 94045. Elle a une note de 3, 5 étoiles basée sur 122 avis et vend de l'hydrogène, du propane et de l'essence, ainsi que des services de lavage auto. Il est ouvert jusqu'à 21h50 ce soir et dispose de toilettes.
  • Station-service fictive : située au 456 Fictional Ave, Sunnyvale, CA 94045. Elle a une note de 3,6 étoiles basée sur 52 avis, et propose une supérette et un service de lavage de voitures. Cette station est ouverte 24h/24 et dispose de toilettes.
  • Station-service générique : située au 789 W Generic St, Sunnyvale, CA 94045. Il a une note de 3,6 étoiles basée sur 35 avis. Cette station est ouverte 24h/24 et dispose de toilettes.

Exemple de requête [Recherche d'itinéraire à plusieurs étapes] :

Je vais faire un road trip de San Francisco à Los Angeles en passant par San Luis Obispo. Peux-tu me suggérer trois options de bornes pour véhicules électriques entre San Francisco et San Luis Obispo, puis entre San Luis Obispo et Los Angeles ?

Exemple de réponse [recherche d'itinéraire à plusieurs étapes] :

Voici quelques options de bornes pour véhicules électriques pour votre road trip de San Francisco à Los Angeles, avec des arrêts à San Luis Obispo.

Entre San Francisco et San Luis Obispo :

  • Exemple de borne de recharge : située au 123 Example Blvd, Campbell, CA 95008, cette borne a une note de 4,5.
  • Fictional EV Station : vous trouverez cette station au 456 Fictional Rd, Gilroy, CA 95008.Elle a une note de 4, 4.
  • Generic Charging Station : cette station se trouve au 789 Generic St, Salinas, CA 95008, et sa note est de 3,5.

Entre San Luis Obispo et Los Angeles :

  • Exemple de borne de recharge : située au 123 Example Rd, San Luis Obispo, CA 93123, cette borne a une note de 4,3.
  • Fictional EV Station : cette station se trouve au 456 Fictional Ave, Santa Barbara, CA 93123, et a une note de 3,9.
  • Generic Charging Station : cette borne se trouve au 789 Generic St, Glendale, CA 93123, et sa note est de 3.

Bon voyage !

Conditions d'utilisation des services

Cette section décrit les conditions d'utilisation du service pour l'ancrage avec Google Maps.

Informer l'utilisateur de l'utilisation de sources Google Maps

Pour chaque résultat ancré Google Maps, vous recevrez des sources dans groundingChunks qui étayent chaque réponse. Les métadonnées suivantes sont également renvoyées :

  • URI source
  • titre
  • ID

Lorsque vous présentez des résultats de l'Ancrage avec Google Maps avec Gemini Enterprise Agent Platform, vous devez spécifier les sources Google Maps associées et informer vos utilisateurs des points suivants :

  • Les sources Google Maps doivent suivre immédiatement le contenu généré qu'elles appuient. Ce contenu généré est également appelé Résultat ancré Google Maps.
  • Les sources Google Maps doivent être visibles en une seule interaction de l'utilisateur.

Pour les interfaces axées sur la voix

Sourcing : les sources Google Maps doivent être affichées dans une UI associée qui présente un historique textuel de toute conversation vocale avec l'IA. Cet enregistrement doit respecter les exigences concernant les sources et est soumis aux limites applicables en termes de mise en cache et de stockage des données.

Divulgation active des sources : les utilisateurs finaux doivent être raisonnablement informés du rôle de Google Maps dans leur expérience et de la manière de trouver des informations détaillées sur les sources au moment de l'interaction.

La divulgation active des sources doit transmettre les points suivants :

  • Le contenu généré par l'IA peut inclure des informations provenant de Google Maps.

  • Les sources détaillées sont disponibles dans l'interface utilisateur associée.

Vous devez indiquer activement les sources en utilisant au moins une des méthodes suivantes.

  • Affichage visuel : pour les interactions vocales qui se produisent sur un appareil doté d'un écran, affichez la divulgation active à l'écran chaque fois que l'ancrage avec Google Maps est utilisé.

  • Annonce vocale : lisez le communiqué actif à l'utilisateur. Cela doit se produire lors de la première interaction compatible avec l'ancrage avec Google Maps et se répéter au moins tous les six mois.

Exemple de mention : "Le contenu généré par IA peut inclure des informations provenant de Google Maps. Vous trouverez des sources détaillées dans l'application associée."

Divulgation persistante : une explication indiquant que le contenu Google Maps peut être utilisé dans du contenu généré par l'IA doit être accessible en permanence à l'utilisateur final (par exemple, dans un menu de paramètres vocaux ou une divulgation d'interaction vocale).

Demandes des utilisateurs : votre assistant vocal doit répondre avec précision aux demandes des utilisateurs finaux concernant la source du contenu, y compris lorsque le contenu généré par l'IA inclut des informations provenant de Google Maps. Si Google Maps est la source, redirigez les utilisateurs finaux vers l'UI associée pour accéder à des informations spécifiques sur la source.

Pour chaque source dans groundingChunks, un aperçu du lien doit être généré en respectant les exigences suivantes :

Ces images montrent les exigences minimales pour afficher les sources et les liens Google Maps.

Prompt avec réponse affichant les sources

Vous pouvez réduire la vue des sources.

Requête avec réponse et sources réduites

Facultatif : Améliorez l'aperçu du lien en ajoutant du contenu, par exemple :

  • Un favicon Google Maps est inséré avant l'attribution textuelle Google Maps.
  • Une photo de l'URL source (og:image).

Pour en savoir plus sur certains de nos fournisseurs de données Google Maps et leurs conditions de licence, consultez les mentions légales de Google Maps et Google Earth.

Consignes d'attribution textuelle pour Google Maps

Lorsque vous attribuez des sources à Google Maps dans un texte, suivez ces consignes :

  • Ne modifiez en aucun cas le texte Google Maps :
    • Ne modifiez pas la casse de Google Maps.
    • Ne répartissez pas Google Maps sur plusieurs lignes.
    • Ne localisez pas Google Maps dans une autre langue.
    • Empêchez les navigateurs de traduire Google Maps en utilisant l'attribut HTML translate="no".
  • Appliquez un style au texte Google Maps comme décrit dans le tableau suivant :
Propriété Style
Famille de polices Roboto. Le chargement de la police est facultatif.
Famille de polices de remplacement Toute police de corps sans empattement déjà utilisée dans votre produit ou "Sans-Serif" pour appeler la police système par défaut
Style de police Normal
Épaisseur de la police 400
Couleur de la police Blanc, noir (#1F1F1F) ou gris (#5E5E5E). Maintenez un contraste accessible (4,5:1) par rapport à l'arrière-plan.
Taille de police Taille de police minimale : 12 sp
Taille de police maximale : 16 sp
Pour en savoir plus sur les sp, consultez la section "Font size units" (Unités de taille de police) sur le site Web Material Design.
Espacement entre les lettres Normal

Exemple de CSS

Le code CSS suivant affiche Google Maps avec le style typographique et la couleur appropriés sur un arrière-plan blanc ou clair.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

ID de lieu et ID d'avis

Les données Google Maps incluent l'ID de lieu et l'ID d'avis. Vous pouvez mettre en cache, stocker et exporter les données de réponse suivantes :

  • placeId
  • reviewId

Les restrictions concernant la mise en cache dans les conditions d'utilisation de l'Ancrage avec Google Maps ne s'appliquent pas.

Territoire interdit

L'ancrage avec Google Maps est soumis à des restrictions pour certains contenus et activités afin de maintenir une plate-forme sûre et fiable. Le Client s'engage à ne pas distribuer ni commercialiser d'Application du Client qui propose l'Ancrage avec Google Maps dans un Territoire interdit. Pour en savoir plus, consultez Territoires interdits sur Google Maps Platform. La liste des territoires interdits peut être mise à jour de temps en temps.

Facturation

L'ancrage avec Google Maps est facturé pour chaque requête Google Maps (voir Tarifs).

Une requête envoyée par un client à Gemini peut générer une ou plusieurs requêtes à Google Maps. Le tableau suivant présente quelques exemples :

Exemple de prompt Nombre potentiel de requêtes Google Maps Exemple de génération de requête
Restaurants de sushis près de l'hôtel Hilton (1335 6th Ave à New York). 3 requêtes de Place Search (requêtes Google Maps), en supposant que ce prompt génère 3 requêtes de distribution. 3 requêtes Place Search avec sortance :
- Meilleurs sushis près de Hilton Midtown Manhattan
- Restaurants de sushis près de 1335 6th Ave New York
- Restaurants japonais près de 1335 6th Ave New York
Comment aller au 200 W 44th St, New York depuis l'hôtel Hilton, 1335 6th Ave ? 1 requête de recherche d'itinéraire (requête Google Maps) 1 requête de recherche d'itinéraire :
- Itinéraire entre l'hôtel Hilton, 1335 6th Ave, New York, NY et le 200 W 44th St, New York, NY 10036
Distance entre l'hôtel Hilton (1335 6th Ave à New York) et l'aéroport. 4 requêtes Google Maps (1 requête Place Search + 3 requêtes Find Directions), en supposant que la recherche de lieux renvoie 3 aéroports. 1 requête de Place Search avec expansion :
- Aéroports près de New York

3 requêtes d'itinéraire :
- Itinéraire de 1335 6th Ave, New York, NY 10019, États-Unis à John F. Kennedy International Airport, Queens, NY 11430, USA
- Directions from 1335 6th Ave, New York, NY 10019, USA to Newark Liberty International Airport, Newark, NJ 07114, USA
- Directions from 1335 6th Ave, New York, NY 10019, USA to LaGuardia
Trouve des stations-service sur le trajet entre 1800 Amphibious Blvd. Mountain View, CA 94045 et 456 Sunny St, Sunnyvale CA. 1 requête "Rechercher sur l'itinéraire" (requête Google Maps) 1 requête de recherche le long de l'itinéraire :
- Stations-service entre le 1800 Amphibious Blvd. Mountain View, CA 94045 et le 456 Sunny St, Sunnyvale CA

Étapes suivantes

  • Pour savoir comment ancrer des modèles Gemini sur vos données, consultez Ancrage basé sur vos propres données.
  • Pour en savoir plus sur les bonnes pratiques d'IA responsable et les filtres de sécurité de Gemini Enterprise Agent Platform, consultez IA responsable.