Cette page explique comment l'ancrage avec Google Maps et Vertex AI 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 et Vertex AI est un service qui connecte 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 points de repère 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 donner plus d'informations sur les 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.
Gemini 3 Pro et Gemini 3 Pro Image sont limités à 5 000 requêtes de recherche par jour.
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.
Les résultats de recherche peuvent être personnalisés pour un emplacement géographique spécifique à l'aide des coordonnées de latitude et de longitude. Pour en savoir plus, consultez l'API Ancrage.
Console
Pour utiliser l'ancrage avec Google Maps avec Vertex AI, procédez comme suit :
Dans la console Google Cloud , accédez à la page Vertex AI Studio.
Dans la section Outils, cliquez sur Ancrage : Google. Un volet de configuration s'affiche.
Pour utiliser Google Maps, cliquez sur le bouton bascule Google Maps.
Cliquez sur Appliquer.
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 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_VERTEXAI=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(
enable_widget=False # Optional: return Maps widget token
))
],
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 : 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.7749représente San Francisco. Vous pouvez obtenir les 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.4194représente San Francisco. - ENABLE_WIDGET : indique s'il faut renvoyer un jeton et activer le widget Google Maps (la valeur par défaut est
false).
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": {
"enableWidget": "ENABLE_WIDGET"
}
}],
"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
]
},
],
"googleMapsWidgetContextToken": "widgetcontent/..."
}
}
],
...
}
Propriétés du lieu
Cette section liste les propriétés de lieu utilisées pour décrire les lieux et utilisées 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 lieu
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
- Drive disponible
- Carte de débit
- Distance
- Parking gratuit
- Concerts
- Menu pour enfants
- Horaires d'ouverture
- Options de paiement (espèces ou carte de crédit, par exemple)
- Réponse sur le lieu
- Animaux acceptés
- Bière
- Sert des plats végétariens
- Accessible en fauteuil roulant
- Wi-Fi
Les réponses sur les lieux sont des réponses fournies par l'ancrage avec Google Maps, basées sur des informations issues des avis des utilisateurs.
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 "The Italian Place" est-il adapté aux enfants et propose-t-il 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.
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 "Est-ce que le restaurant "Burger Joint" est ouvert maintenant ?" Sert-il à dîner ? Quels sont leurs horaires d'ouverture pour vendredi ?
Les réponses à ces questions vous aident à trouver un établissement ouvert qui sert un repas spécifique à une heure précise.
Prendre un café avec un client : vous pouvez demander Le "Café Central" a-t-il le Wi-Fi ? Sert-il du café ? Quel est leur niveau de prix et acceptent-ils les cartes de crédit ?
Les réponses à ces questions vous aident à évaluer si un café est adapté à une réunion d'affaires en fonction des services, des offres et des options de paiement.
Les informations contenues dans les résultats ancrés Google Maps peuvent différer des conditions réelles de la route.
Comprendre votre réponse
Les sources Google Maps sont renvoyées dans groundingMetadata dans groundingChunks. Les sources sont renvoyées pour les lieux et les avis des utilisateurs qui ont été utilisés pour générer le résultat ancré Google Maps.
Cet exemple de code montre une source de lieu et une source de réponse de lieu dans la réponse :
"groundingChunks": [
{
"maps": {
"uri": "{Link to Maps Content}",
"title": "{Name of Maps Place}",
"placeId": "{Place ID}",
"placeAnswerSources": {
"reviewSnippets" : [
{
"reviewId": "{Review ID}",
"googleMapsUri": "{Link to Maps Content}",
"title": "{Title of review}"
}
]
}
},
}
],
Routage
L'ancrage avec Google Maps est compatible avec les fonctionnalités de routage. Cette fonctionnalité permet à vos agents d'IA de comprendre les mouvements physiques, les estimations de temps de trajet en temps réel et les relations spatiales entre les lieux. En ancrant les réponses dans le moteur de calcul d'itinéraire de Google Maps, 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 proposer des itinéraires précis de point à point et de calculer les temps de trajet estimés pour des modes de transport spécifiques.
Les fonctionnalités de routage sont disponibles en preview restreinte. Pour accéder à cette fonctionnalité pour votre projet, contactez votre équipe chargée du compte Google Cloud pour demander à être ajouté à la liste d'autorisation. Vous pouvez également envoyer le formulaire de participation pour être pris en compte. Google accepte les demandes d'un nombre limité de partenaires pour tester l'outil d'ancrage avec le routage Google Maps.
Capacités
L'outil de routage calcule précisément les distances et les durées de trajet entre les points de départ et les destinations.
L'outil de routage est compatible avec les éléments suivants :
Modes de transport : itinéraires 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 "en direct" précis plutôt que des moyennes statiques
Voici des exemples de questions que l'outil de routage peut traiter :
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 ?"
Comprendre la réponse
Lorsqu'une requête déclenche l'outil de routage, le modèle génère une réponse en langage naturel basée sur 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 restaurant Carmine's - Time Square, au 200 W 44th St, New York, NY 10036, États-Unis.
Voici l'itinéraire à pied :
Commencez à l'hôtel Hilton : sortez de l'hôtel Hilton au 1335 6th Ave.
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.
Tournez à droite sur W 44th Street.
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 entre 10 et 15 minutes.
Voici un exemple de réponse à la requête : "Combien de temps faut-il pour aller en transports en commun de Pike Place Market à Capitol Hill à Seattle ?"
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, près de Pike Place Market, à Capitol Hill dure environ trois minutes. En comptant les transferts, le temps de trajet total est d'environ neuf minutes, et les tramways 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 11 minutes environ, avec des départs toutes les 20 minutes. Vous pouvez également prendre la ligne de bus 49, qui met environ 16 minutes.
Rechercher sur le trajet
La recherche le long d'un 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 voyage sur route ou d'un trajet domicile-travail.
Les fonctionnalités de recherche le long d'un itinéraire sont disponibles en version Preview restreinte. Pour accéder à cette fonctionnalité pour votre projet, veuillez contacter l'équipe responsable de votre compte Google Cloud pour demander à être ajouté à la liste d'autorisation. Vous pouvez également remplir ce formulaire pour être pris en compte. Notez que, pour le moment, nous n'acceptons que les demandes d'un nombre limité de partenaires pour tester l'outil d'ancrage avec la recherche Google Maps le long d'un itinéraire.
Capacités
La recherche le long du trajet permet à votre application d'identifier des établissements, des commodités ou des attractions spécifiques situés directement le long d'un itinéraire généré entre une origine et une destination. Seul le mode de déplacement "Voiture" est disponible dans l'aperçu.
Les exemples suivants illustrent les types de questions auxquelles l'outil Rechercher le long du trajet peut répondre.
- 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. Peux-tu me suggérer trois bornes de recharge pour véhicules électriques entre San Francisco et San Luis Obispo, puis entre San Luis Obispo et Los Angeles ?"
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 basée sur des métadonnées structurées qui combinent les données Places 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. Il 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 de recharge 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, boulevard Exemple, 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.
Bon voyage !
Conditions d'utilisation du service
Cette section décrit les conditions d'utilisation de l'ancrage avec Google Maps.
Informer l'utilisateur sur l'utilisation des sources Google Maps
Pour chaque résultat ancré Google Maps, vous recevrez des sources en groundingChunks qui étayent chaque réponse. Les métadonnées suivantes sont également renvoyées :
- URI source
- title
- ID
Lorsque vous présentez des résultats d'ancrage avec Google Maps dans Vertex AI, 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 soutiennent. 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 de mise en cache et de stockage des données applicables.
Divulgation active des sources : les utilisateurs finaux doivent être raisonnablement informés du rôle que joue 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 IA peuvent inclure des informations provenant de Google Maps.
Des sources détaillées sont disponibles dans l'UI associée.
Vous devez communiquer la divulgation active des 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'utilisateur la mention d'information active. 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."
Informations permanentes : 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 dans des informations sur l'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.
Afficher les sources Google Maps avec des liens Google Maps
Pour chaque source dans groundingChunks et dans grounding_chunks.maps.placeAnswerSources.reviewSnippets, un aperçu du lien doit être généré en respectant les exigences suivantes :
- Attribuez chaque source à Google Maps en suivant les Consignes concernant l'attribution de texte Google Maps.
- Affichez le titre de la source fourni dans la réponse.
- Créez un lien vers la source à l'aide de
uriougoogleMapsUrià partir de la réponse.
Ces images montrent les exigences minimales pour afficher les sources et les liens Google Maps.
Vous pouvez réduire l'affichage des sources.
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 relatives à 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'insérez 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 page Unités de taille de police sur le site Web Material Design. |
| L'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;
}
Jeton de contexte, ID du lieu et ID de l'avis
Les données Google Maps incluent le jeton de contexte, l'ID de lieu et l'ID d'avis. Vous pouvez mettre en cache, stocker et exporter les données de réponse suivantes :
googleMapsWidgetContextTokenplaceIdreviewId
Les restrictions de mise en cache des conditions d'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.
(Facultatif) Widget contextuel Google Maps
Le widget contextuel est une offre Google Maps en pré-DG. Il s'agit d'un conteneur visuel utilisé pour prendre en charge ou compléter d'autres contenus Google Maps. Le widget contextuel Google Maps vous permet d'intégrer l'ancrage avec Google Maps dans vos applications pour créer une expérience de chat conversationnelle optimisée par les LLM.
Le widget contextuel est affiché à l'aide du jeton de contexte googleMapsWidgetContextToken, qui est renvoyé dans la réponse de l'API Vertex AI et peut être utilisé pour afficher du contenu visuel.
Le widget contextuel remplit différentes fonctions selon votre scénario :
Il affiche les avis et les photos des utilisateurs, qui sont des contenus générés par les utilisateurs (CGU), dans le scénario où l'invite Google Maps est utilisée pour générer des réponses.
Il permet d'enrichir les résultats avec des visualisations et des données cartographiques lorsque Vertex AI ne génère qu'une réponse textuelle.
Pour en savoir plus sur le widget contextuel, consultez Widget d'ancrage Maps.
Afficher le widget contextuel Google Maps
Pour afficher et utiliser le widget contextuel Google Maps, utilisez la version alpha de l'API Maps JavaScript sur la page qui affiche le widget. Pour en savoir plus, consultez Charger l'API Maps JavaScript.
Les exemples de code suivants montrent comment utiliser un widget contextuel :
Créez un widget contextuel.
<body> <gmp-place-contextual id="widget"></gmp-place-contextual> </body>Dans toute réponse ancrée dans Google Maps, un
googleMapsWidgetContextTokencorrespondant est utilisé pour afficher le widget contextuel et placé à proximité de la réponse générée.Pour mettre à jour le jeton de contexte, définissez
widget.contextToken property."googleMapsWidgetContextToken": "widgetcontent/AcBXPQdpWQWbap9H-OH8sEKmOXxmEKAYvff0tvthhneMQC3VrqWCjpnPBl4-Id98FGiA_S_t8aeAeJj0T6JkWFX56Bil8oBSR0W8JH3C_RSYLbTjxKdpxc9yNn6JcZTtolIRZon9xi6WpNGuSyjcIxWu2S0hwpasNOpUlWrG1RxVCB4WD1fsz_pwR236mG36lMxevXTQ_JnfdYNuQwQ4Lc3vn...<snip>... Ts5VJE_b3IC5eE_6wez0nh61r7foTUZpP7BXMwxR-7Wyfcj6x1v6mIWsFGr1o0p_HSAMNqWPg-aFVnkPLhAkOR6MaNZOfezTva-gxHlu7z_haFvYxcUE1qfNVQ",function updateWidget(contextToken) { let widget = document.querySelector('#widget'); widget.contextToken = contextToken; }Facultatif : Spécifiez la mise en page de la liste. Les valeurs valides sont les suivantes:
- Mise en page compacte :
<gmp-place-contextual-list-config layout="compact"> - Mise en page verticale :
<gmp-place-contextual-list-config layout="vertical">
Cet exemple de code montre comment modifier la mise en page de la liste pour la rendre compacte.
<gmp-place-contextual id="widget"> <gmp-place-contextual-list-config layout="compact"> </gmp-place-contextual-list-config> </gmp-place-contextual>- Mise en page compacte :
Facultatif : Modifiez le mode Plan. Les valeurs valides sont les suivantes:
- Carte de route 2D :
map-mode="roadmap" - Carte hybride 3D :
map-mode="hybrid" - Aucune carte :
map-mode="none"
Cet exemple de code montre comment passer au mode Plan 2D.
<gmp-place-contextual id="widget"> <gmp-place-contextual-list-config map-mode="roadmap"> </gmp-place-contextual-list-config> </gmp-place-contextual>- Carte de route 2D :
Étapes suivantes
- Pour savoir comment ancrer des modèles Gemini sur vos données, consultez Ancrage avec vos données.
- Pour en savoir plus sur les bonnes pratiques d'IA responsable et les filtres de sécurité de Vertex AI, consultez IA responsable.