Ancrage avec Google Maps dans Gemini Enterprise Agent Platform

Cette page explique comment l'ancrage avec Google Maps et 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 sur Gemini Enterprise Agent Platform est un service qui associe 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 de lieux spécifiques, comme une borne de recharge VE ou un hôtel.

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

Modèles compatibles

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

Cliquer pour développer les 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 Modifier pour Recherche Google, Google Maps. Un volet de configuration s'affiche.

  3. Activez l'option Google Maps.

  4. Cliquez sur Appliquer.

  5. Saisissez votre requête dans le champ, puis cliquez sur Envoyer. Vos réponses aux requêtes sont ancré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 : trouvez des itinéraires et effectuez des recherches le long de votre trajet.
    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
  • Options de paiement (comme espèces ou carte de crédit)
  • 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.

  • Organiser un dîner en famille : vous pouvez demander "Est-ce que "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" ? Proposent-ils des plats végétariens ? Que disent les évaluateurs de leur 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 requête peut vous aider à déterminer si le lieu répond à des besoins spécifiques en matière d'accessibilité.

  • Trouver un endroit pour une collation tardive : vous pouvez demander "Burger Joint" est-il ouvert en ce moment ? Proposent-ils un dîner ? Quels sont leurs horaires d'ouverture pour vendredi ?

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

  • Planifier la recharge de votre véhicule électrique et les équipements de l'hôtel pour un road trip : vous pouvez demander Je séjourne à l'hôtel "Overnight Motel". Dispose-t-il de bornes de recharge pour véhicules électriques sur place ? Quels types de connecteurs sont pris en charge ? Quelle est l'affluence dans son parking le vendredi soir ?

    Les réponses à ces questions combinent des informations sur les bornes de recharge VE et des tendances d'affluence pour vous aider à planifier la recharge de votre véhicule et à évaluer le niveau d'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 à un avis ou directement à la fiche du lieu sur Google Maps.

Cet exemple de code montre 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}"
    }
  }
],

Routing : trouver un itinéraire

L'ancrage avec Google Maps est compatible avec la fonctionnalité Trouver un itinéraire. Cette fonctionnalité permet à vos agents d'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é Trouver un itinéraire, votre modèle peut fournir des itinéraires optimisés en termes de 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 fournir des itinéraires précis de point à point 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.

Find Directions 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 trafic actuelles pour fournir des temps de trajet "en direct" précis 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 est défini par défaut sur les données Places uniquement lorsque grounding_types est omis. Pour activer les fonctionnalités de directions, 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 à 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 d'un lieu à un autre, en tenant compte du trafic si demandé. Par exemple, "500 secondes".

  • Distance : distance physique de l'itinéraire. Par 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 diriger vers le Carmine's de Times Square, 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 6e Avenue : dirigez-vous vers le sud sur la 6e Avenue (Avenue of the Americas) en direction de la W 44th Street.

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

  4. Carmine's se trouve sur votre gauche : marchez sur 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 Pikes Place Market à Capitol Hill à Seattle en transports en commun ?"

Pour vous rendre de Pike Place Market à 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 transferts, le temps de trajet total est d'environ neuf minutes, avec des tramways qui partent 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 environ 11 minutes, avec des départs toutes les 20 minutes. Vous pouvez également prendre la ligne 49, qui met environ 16 minutes.

Calcul d'itinéraire : rechercher sur le trajet

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 en chemin entre 1800 Amphibious Blvd, Mountain View, CA 94045 et 456 Sunny St, Sunnyvale, CA." (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 le long du trajet

La fonctionnalité Rechercher sur le trajet nécessite les fonctionnalités Places et Routing pour découvrir les lieux situés le long d'un itinéraire de voyage. 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'une requête déclenche l'outil Rechercher le long du trajet, le modèle génère une réponse en langage naturel appuyée par des métadonnées structurées qui combinent les données de lieux et de routage. 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 en chemin entre 1800 Amphibious Blvd, Mountain View, CA 94045 et 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 lave-auto. 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 à étapes multiples] :

Je pars en road trip de San Francisco à San Luis Obispo, puis à Los Angeles. Peux-tu me suggérer trois options de bornes de recharge 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 à étapes multiples] :

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.
  • Borne de recharge fictive pour véhicules électriques : vous trouverez cette borne au 456 Fictional Rd, Gilroy, CA 95008, avec une note de 4,4.
  • Borne de recharge générique : cette borne se trouve au 789 Generic St, Salinas, CA 95008 et a une note 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.
  • Borne de recharge fictive pour véhicules électriques : cette borne se trouve au 456 Fictional Ave, Santa Barbara, CA 93123, et a une note de 3,9.
  • Borne de recharge générique : vous trouverez cette borne au 789 Generic St, Glendale, CA 93123, avec une note de 3.0.

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 des 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 d'ancrage avec Google Maps à l'aide de 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 prennent en charge. 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 vocales

Sources : les sources Google Maps doivent être affichées dans une UI associée qui présente un enregistrement historique verbatim 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 :

  • Les contenus générés par l'IA peuvent inclure des informations provenant de Google Maps.

  • Des sources détaillées sont disponibles dans l'UI 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 mention active sur l'écran chaque fois que l'ancrage avec Google Maps est utilisé.

  • Annonce vocale : lisez l'avis de confidentialité actif à l'utilisateur. Cela doit se produire lors de la première interaction prise en charge par 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."

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

Demandes des utilisateurs : votre assistant vocal doit répondre précisément aux demandes des utilisateurs finaux concernant la source du contenu, y compris lorsque le contenu généré par 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.

Requête avec réponse affichant les sources

Vous pouvez réduire l'affichage 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 de texte Google Maps.
  • Photo provenant de l'URL source (og:image).

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

Consignes concernant l'attribution de texte 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.
    • N'affichez 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".
  • Mettez en forme le 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 serif 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 clair ou blanc.

@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 de mise en cache des 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 une 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. Vous trouverez quelques exemples dans le tableau suivant :

Exemple de prompt Nombre potentiel de requêtes Google Maps Exemple de génération de requêtes
Restaurants de sushis à proximité de l'hôtel Hilton (1335 6th Ave à New York). 3 requêtes Place Search (requêtes Google Maps), en supposant que ce prompt génère 3 requêtes fan-out. 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 se rendre au 200 W 44th St, New York depuis l'hôtel Hilton, 1335 6th Ave. 1 requête d'itinéraire (requête Google Maps) 1 Requête "Trouver un itinéraire" :
- Itinéraire de l'hôtel Hilton, 1335 6th Ave, New York, NY à 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 distribution :
- 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, États-Unis
- Itinéraire de 1335 6th Ave, New York, NY 10019, États-Unis à Newark Liberty International Airport, Newark, NJ 07114, États-Unis
- Itinéraire de 1335 6th Ave, New York, NY 10019, États-Unis à LaGuardia
Trouve des stations-service en chemin 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 "Rechercher le long de l'itinéraire" :
- Stations-service de 1800 Amphibious Blvd, Mountain View, CA 94045 à 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.