Cette page a été traduite par l'API Cloud Translation.

Capacités du modèle Gemini pour l'API Places

Les capacités des modèles Gemini pour l'API Places (nouvelle version) sont compatibles avec les LLM. Vous pouvez ainsi renvoyer les données associées à un lieu (horaires d'ouverture, avis, photos) ainsi que les données fournies par les LLM. Ces données génératives contiennent des données agrégées et résumées provenant des LLM afin d'améliorer les données déjà associées à un lieu.

Par exemple, une requête Text Search (New) standard pour "bornes de recharge de VE" renvoie une liste des lieux qui proposent des bornes de recharge de VE. Ce type de réponse est adapté si vous recherchez simplement le chargeur de VE le plus proche ou celui compatible avec votre véhicule le plus proche.

Toutefois, vous voudrez peut-être également mieux comprendre la zone autour de la borne de recharge, en particulier si vous vous rendez sur place pendant une heure ou plus pendant que votre véhicule est en charge. Lorsque vous utilisez les fonctionnalités du modèle Gemini pour cette même recherche, la réponse peut contenir des descriptions dynamiques et génératives de chaque lieu dans la réponse, y compris des informations sur la zone autour de la borne de recharge:

« À 2 à 4 minutes à pied, vous trouverez plusieurs restaurants et boutiques, dont Chef Chu's, Gen Korean Barbecue, Amber India, Pacific Catch, et plusieurs épiceries comme Walmart, Whole Foods Market et Trade Joe's. »
« À moins de 1-5 minutes à pied, vous trouverez plusieurs restaurants et boutiques, dont Khao Kang Thai Kitchen, Roger's Deli & Donuts et La Costeña. Pour les sushis, Joy Sushi est une bonne option. Pour les produits alimentaires, Dollar Tree offre une variété de produits à prix réduit. »

Ce contenu génératif issu des LLM améliore la réponse et fournit des informations supplémentaires pour aider les utilisateurs à prendre une décision éclairée.

Nouvelles fonctionnalités optimisées par l'IA ajoutées à l'API Places (nouveau)

Ces fonctionnalités ajoutent les données suivantes à une réponse de l'API Places (New) :

Les récapitulatifs génératifs des lieux liés à un lieu spécifique. Les résumés de lieux sont compatibles avec Place Details (New), Text Search (New) et Nearby Search (New).
Les récapitulatifs de zones génératifs liés à une zone spécifique autour d'un lieu. Les résumés de zones sont compatibles avec Place Details (New), Text Search (New) et Nearby Search (New).
Les résultats de recherche contextuelle sont compatibles avec Text Search (New) et contiennent des données basées sur la chaîne de recherche transmise dans la requête, plutôt que des données directement associées à un lieu. Ces données aident à comprendre comment Text Search (New) détermine la réponse.

Résumés génératifs des lieux

Les résumés génératifs de lieux sont spécifiques à un ID de lieu. Les résumés de lieux regroupent de nombreux types de données différents en un seul résumé pour le lieu.

L'API Places (nouvelle version) fournit deux types de résumés génératifs des lieux:

Résumés de la présentation: bref aperçu d'un lieu (en moyenne 100 caractères environ) qui peut aider les utilisateurs à se faire une idée de ce lieu.
Résumés de descriptions: résumés plus longs d'un lieu (en moyenne 400 caractères environ) qui fournissent un aperçu détaillé des principaux aspects du lieu.

Des résumés de lieux sont actuellement disponibles pour les types de lieux figurant dans la section Types compatibles pour les catégories Culture, Divertissement et loisirs, Alimentation et boissons, Shopping et Sport.

Résumés génératifs des zones

Les résumés génératifs de zones sont créés par le LLM pour la zone à proximité d'un lieu. Le résumé de la zone d'un lieu peut contenir toutes les informations dont l'utilisateur a besoin pour prendre une décision, sans que celui-ci n'ait à effectuer d'autres requêtes pour afficher le détail de la zone.

En plus de la description de la zone, la réponse contient également une liste d'ID de lieu pour les lieux référencés dans la description, ainsi qu'une liste de lieux triés par différents types de contenus. Par exemple, un type de contenu contient une liste de lieux associés à des activités dans la zone, et un autre contient une liste de restaurants dans la zone.

Des résumés de zones sont actuellement disponibles pour les types de lieux affichés dans Types compatibles dans la catégorie Hébergement, ainsi que pour les types de lieux spécifiques electric_vehicle_charging_station, geocode et premise.

Génération de résumés de lieux et de zones

Les résumés génératifs des lieux et les résumés génératifs des aires sont fréquemment générés hors connexion par Google. En générant ces résumés hors connexion, vous pouvez bénéficier du contenu fourni par Gemini, tout en conservant les mêmes performances de l'API Places (nouvelle) que celles auxquelles vous vous attendez déjà.

Google regénère fréquemment ces résumés pour s'assurer qu'ils sont à jour sur la base des dernières informations disponibles. Cela signifie que vous afficherez les données les plus récentes de votre service lorsque vous appelez l'API.

Résultats de recherche contextuels

Une requête Text Search (New) renvoie des informations sur un ensemble de lieux en fonction d'une chaîne (par exemple, "pizza à New York" ou "magasins de chaussures près d'Ottawa"). La réponse Text Search (New) contient la liste des lieux correspondant à la chaîne de texte et aux biais de localisation définis dans la requête.

Lorsque vous ajoutez des résultats de recherche contextuels à la réponse, celle-ci inclut désormais des avis, des photos et des justifications qui aident les utilisateurs à répondre aux questions:

Pourquoi ce lieu s'affiche-t-il dans les résultats ?
Pourquoi choisir ce lieu ?

Par exemple, vous envoyez aujourd'hui une requête à Place Details (New), Text Search (New) ou Nearby Search (New) qui inclut un lieu spécifique dans la réponse. Les données de réponse pour le lieu sont les mêmes pour les trois requêtes, car les données renvoyées sont associées à ce lieu.

Toutefois, pour une recherche de texte (New) utilisant les nouvelles fonctionnalités, la réponse peut inclure des données dérivées de la chaîne de requête d'entrée elle-même. Cela signifie que les résultats de recherche contextuelle sont uniques à la chaîne de requête. Par exemple, vous exécutez une requête Text Search (New) avec la chaîne de requête suivante:

"Restaurant végétarien épicé à Mountain View, CA"

Vous conservez ensuite tous les paramètres d'entrée et ne modifiez que la chaîne de requête suivante:

"Restaurant vegan épicé à Mountain View, CA"

Pour un restaurant qui apparaît dans les deux réponses, les données de réponse concernant le lieu sont identiques, car elles sont associées au lieu lui-même. Toutefois, les résultats de recherche contextuelle sont uniques à la requête, car ils sont dérivés de la chaîne de requête. Vous pouvez ensuite présenter à vos utilisateurs les avis, les photos et les justifications issus des résultats de la recherche contextuelle pour les aider à décider du lieu dans la réponse qui convient le mieux à leur requête de recherche.

Activer les fonctionnalités du modèle Gemini pour l'API Places (nouvelle version)

Pour utiliser les fonctionnalités des modèles Gemini pour l'API Places (nouvelle version), vous devez activer l'API Places (nouvelle version). Pour en savoir plus, consultez Configurer votre projet Google Cloud.

Restrictions concernant la version expérimentale

Cette version n'accepte que les résumés de lieux et de zones géographiques aux États-Unis, en anglais uniquement.

Qu'est-ce que Gemini ?

Pour en savoir plus sur le modèle Gemini, consultez les questions fréquentes sur Gemini.

Demander un résumé génératif des lieux

Les résumés de lieux sont des résumés génératifs créés par le LLM pour un lieu spécifique. L'API Places (nouvelle version) ajoute deux types de résumés à une réponse:

Aperçu, qui sont semblables au résumé éditorial statique associé à un lieu. Les résumés courts génératifs, d'environ 100 caractères en moyenne, présentent plusieurs avantages:
- De nombreux lieux ne disposent pas de résumés éditoriaux et comblent donc les informations disponibles.
- Ils sont générés à partir du LLM. Le propriétaire du lieu n'a donc pas besoin de les gérer.
Les résumés générés par les descriptions sont issus de nombreuses sources, y compris les avis provenant de Google Maps. La description, d'environ 400 caractères en moyenne, inclut une liste d'avis permettant de générer la description longue.

Pour générer des résumés de descriptions manuellement, une personne doit agréger des données provenant de nombreux emplacements, puis créer et gérer manuellement le contenu. Les fonctionnalités du modèle Gemini pour l'API Places (nouvelle version) créent ces résumés à partir des LLM afin de maintenir la portée et l'actualisation du contenu généré.

Les résumés de lieux sont compatibles avec Place Details (New), Text Search (New) et Nearby Search (New). Pour inclure le résumé de lieux dans la réponse, incluez le champ suivant dans le masque de champ de la requête:

Place Details: generativeSummary
Text Search et Nearby Search: places.generativeSummary

Le champ generativeSummary contient les champs suivants:

generativeSummary.overview: résumé de la vue d'ensemble générative
generativeSummary.description: résumé de la description générative
generativeSummary.references: tableau comportant jusqu'à cinq avis permettant de fournir du contenu au résumé de la description. S'il n'y a pas de résumé de la description, ce tableau est vide.

Exemple de requête récapitulative d'aperçu

Cet exemple de Text Search ne renvoie que le résumé overview pour les restaurants végétariens épicés à Mountain View, en Californie:

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary.overview" \
https://places.googleapis.com/v1/places:searchText

La réponse contient le champ generativeSummary.overview, qui inclut les éléments overview.text et overview.languageCode:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
          "languageCode": "en-US"
        }
      }
    },
  . . .
}

Exemple de demande de vue d'ensemble et de résumé de description

Cet exemple effectue la même requête que dans l'exemple précédent, mais utilise un masque de champ de places.generativeSummary pour renvoyer l'intégralité de l'objet generativeSummary, y compris les champs generativeSummary.overview, generativeSummary.description et generativeSummary.references:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        },
        "description": {
          "text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
          Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
          available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
          seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
          "languageCode": "en-US"
        },
        "references": {
          "reviews": [
            {
              "name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
              "relativePublishTimeDescription": "12 months ago",
              "rating": 5,
              "text": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "Anam Qureshi",
                "uri": "https://www.google.com/maps/contrib/116859422317024657778/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1dl9FTSmec0x00000000-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
            },
            . . .
          ]
        }
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
          "languageCode": "en-US"
        },
        . . .
}

Demander un résumé de zone générative

Les résumés de zones sont des résumés génératifs créés par le LLM pour la zone à proximité d'un lieu. Les résumés de zones peuvent être importants pour les utilisateurs qui prennent une décision concernant un lieu.

Par exemple, vous souhaitez réserver un hôtel dans une nouvelle ville et vous pouvez trouver un hôtel qui répond à vos critères, mais vous souhaitez également en savoir plus sur la zone autour de l'hôtel. Plutôt que d'examiner une carte de la zone environnante et de devoir examiner chaque lieu sur la carte, vous pouvez générer un résumé de la zone pour l'hôtel.

Les résumés de zones sont compatibles avec Place Details (New), Text Search (New) et Nearby Search (New).

Pour inclure le résumé des zones dans la réponse, incluez le masque de champ de la requête:

areaSummary (Place Details)
places.areaSummary (Text Search et Nearby Search).

Le champ areaSummary d'un lieu dans la réponse contient un tableau comportant jusqu'à quatre contentBlocks. Le thème de chaque bloc dépend du type de lieu:

Pour une borne de recharge de VE, définie comme un lieu de type electric_vehicle_charging_station, les blocs de thèmes incluent: "overview", "coffee", "restaurant" et "store".
Pour un lieu dont le type est défini par la catégorie Hébergement, et les types de lieux spécifiques geocode et premise, les blocs de thèmes incluent: "overview", "activity", "restaurant" et "store".

Exemple de requête de résumé de la zone d'une borne de recharge de VE

Cet exemple de requête Place Details renvoie le résumé de la zone correspondant à une borne de recharge de VE spécifique à Mountain View, identifiée par l'ID de lieu ChIJC5b6QKiwj4ARgn2EwlnJnWU:

curl -X GET -H 'Content-Type: application/json' \
  -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: id,displayName,areaSummary" \
  https://places.googleapis.com/v1/places/ChIJC5b6QKiwj4ARgn2EwlnJnWU

La réponse contient le champ areaSummary, y compris le tableau contentBlocks:

Le champ topic spécifie le type de bloc de contenu. Étant donné que le lieu dans cet exemple est une borne de recharge de VE, les quatre blocs de contenu sont "overview", "coffee", "restaurant" et "store".
Le champ content inclut le résumé de ce sujet, y compris le code de langue.
Le tableau references spécifie les noms des ressources de lieu, au format places/PLACE_ID, utilisés pour fournir du contenu au bloc de contenu.

{
  "id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "areaSummary": {
    "contentBlocks": [
      {
        "topic": "overview",
        "content": {
          "text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
          ]
        }
      },
      {
        "topic": "coffee",
        "content": {
          "text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
          ]
        }
      },
      {
        "topic": "restaurant",
        "content": {
          "text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
            "places/ChIJETHw0F-7j4AR85V_I6OobCI",
            "places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
            "places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
          ]
        }
      },
      {
        "topic": "store",
        "content": {
          "text": "Safeway provides a range of groceries, along with a deli and a bakery.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
          ]
        }
      }
    ]
  }
}

Exemple de requête de résumé de zone pour un hôtel

Cet exemple de requête Text Search recherche des hôtels à Mountain View, en Californie:

curl -X  POST -d '{
  "textQuery": "Hotels",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.areaSummary" \
https://places.googleapis.com/v1/places:searchText

La réponse contient le champ areaSummary, y compris le tableau contentBlocks. La réponse pour les lieux de type "hôtel" contient des blocs de contenu pour les thèmes "overview", "activity", "restaurant" et "store":

{
  "places": [
    {
      "id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
      "displayName": {
        "text": "Shashi Hotel Mountain View, an Urban Resort",
        "languageCode": "en"
      },
      "areaSummary": {
        "contentBlocks": [
          {
            "topic": "overview",
            "content": {
              "text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJo4za6vi5j4ARMua093RgGGA",
                "places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
              ]
            }
          },
          {
            "topic": "activity",
            "content": {
              "text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
              ]
            }
          },
          {
            "topic": "restaurant",
            "content": {
              "text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
                "places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
                "places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
              ]
            }
          },
          {
            "topic": "store",
            "content": {
              "text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJh64-r0O3j4ARy1P41IH2j3k",
                "places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
              ]
            }
          }
        ]
      }
    },
    ...
  ]
}

Demander des résultats de recherche contextuels

La réponse à une requête Text Search (New) contient un tableau de lieux correspondant aux critères de la chaîne de recherche d'entrée. Vous pouvez maintenant demander des données de recherche contextuelle dans la réponse en fonction de la requête d'entrée à envoyer à l'API.

Pour prendre en charge les résumés contextuels, la réponse de Text Search (New) contient un nouveau tableau nommé contextualContents au même niveau que le tableau places de la réponse:

{
  "places": [],
  "contextualContents":[]
}

Chaque élément du tableau contextualContents, de type ContextualContent, se trouve à l'emplacement correspondant dans le tableau, en tant que position dans le tableau places. Autrement dit, l'élément à l'emplacement contextualContents[0] correspond au lieu à l'emplacement places[0].

Chaque élément du tableau contient les champs de tableau suivants:

contextualContents.reviews: tableau comportant jusqu'à trois avis.
contextualContents.photos: tableau comportant jusqu'à cinq photos.
contextualContents.justifications: tableau des justifications du lieu, y compris les suivantes:
- reviewJustification: mettez en avant une section d'un avis d'utilisateur susceptible d'intéresser un utilisateur final.
- businessAvailabilityAttributesJustification : inclut les attributs d'une entreprise qui pourraient intéresser l'utilisateur final.

Pour inclure les résultats de la recherche contextuelle dans la réponse, incluez contextualContents dans le masque de champ de la requête Text Search (New) :

curl -X  POST  -d '{
  "textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
  "openNow": true,
  "maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText

La réponse contient le tableau contextualContents pour chaque lieu de la réponse:

{
  "places": [
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      }
    },
    . . .
  ],
  "contextualContents": [
    {
      "reviews": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
          "relativePublishTimeDescription": "a year ago",
          "rating": 5,
          "text": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
            the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
            enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset
            to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
            We enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Guillaume Riesen",
            "uri": "https://www.google.com/maps/contrib/1131462893/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwG_WXt1SjB1rJg=s128-c-c0x00000000-cc-rp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSUNKZzlhTG53RRAB",
          "relativePublishTimeDescription": "10 months ago",
          "rating": 5,
          "text": {
            "text": "This is a nice little spot to eat at. I'm a big fan of
            curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "This is a nice little spot to eat at. I'm a big fan of curries,
            and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Paul Sacks",
            "uri": "https://www.google.com/maps/contrib/1106671734435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9sVQ=s128-c-c0x00000000-cc-rp-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z"
        },
        . . .
      ],
      "photos": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
          "widthPx": 1920,
          "heightPx": 1080,
          "authorAttributions": [
            {
              "displayName": "A Google User",
              "uri": "//maps.google.com/maps/contrib/113209927655010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgycOLDgOqPRYhzJ0EJlBFyKo9OrmacOo3C5YvrtR4Q=s100-p-k-no-mo"
            }
          ]
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9YNzyjkjDMD15gyobIQtIYg1GFPy3BdQHAaA3iNwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ]
        },
        . . .
      ],
      "justifications": [
        {
          "reviewJustification": {
            "highlightedText": {
              "text": "\"Not too spicy or oily.\"",
              "highlightedTextRanges": [
                {
                  "startIndex": 9,
                  "endIndex": 14
                }
              ]
            },
            "review": {
              "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
              "relativePublishTimeDescription": "10 months ago",
              "rating": 5,
              "text": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "Harpal Kochar",
                "uri": "https://www.google.com/maps/contrib/1166232959/reviews",
                "photoUri": "https://lh3.googleusercoEnzB1zdrNbR00000-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

Conseils d'implémentation pour les cas d'utilisation dans le secteur automobile

Pour la sécurité du conducteur, Google recommande d'afficher les résumés d'IA générative en mode garé pour les expériences automobiles. Si vous affichez des résumés en mode Voiture, les informations affichées à l'écran doivent être simples, claires et concises pour que l'attention du conducteur puisse reprendre rapidement sur la route.

Trois lignes au maximum
120 caractères ou 24 mots maximum
Taille avant minimale de 24 dp

Surtout dans le contexte automobile, il est de la responsabilité du développeur de générer des résumés de l'IA générative de manière sûre et conforme à toutes les lois et réglementations locales.

Attributions

Lorsque vous affichez des avis, des photos et des résumés d'IA générative dans votre application, y compris des résumés de lieux et de zones, vous devez vous assurer d'afficher également les mentions requises.

Afficher les attributions pour les résumés génératifs

Lorsque vous affichez des résumés d'IA générative dans votre application, y compris des résumés de lieux et de zones, vous devez également afficher les attributions nécessaires. Cette section explique comment afficher les attributions en fonction de la manière dont vous affichez les résumés d'IA générative dans votre application.

Dans tous les cas, la mention d'attribution doit respecter la casse de la phrase. L'attribution et le logo Google doivent être conformes à toutes les normes de couleur, de style et de police de caractères. Pour en savoir plus sur ces normes, consultez Règles pour l'API Places (nouvelle version).

Résumé de l'IA générative affiché dans le contexte d'autres données Google

Dans ce cas, l'attribution de l'IA générative peut être affichée seule au-dessus ou en dessous du résumé, en s'appuyant sur l'attribution de Google du contenu ailleurs.

Pour l'attribution, utilisez le texte "Résumé par IA", comme illustré dans cette image:

Pour l'attribution, utilisez le texte Résumé par IA.

Résumé de l'IA générative affiché de manière isolée

Lorsqu'un résumé de l'IA générative apparaît indépendamment de tout autre contenu de Google Maps, il doit inclure à la fois l'attribution de l'IA générative et l'attribution à Google, séparées par un point d'intersection. Pour l'attribution, utilisez le texte "Résumé par IA" et le logo Google, comme illustré sur cette image:

Pour le résumé affiché de manière isolée, incluez l'attribution de l'IA générative et l'attribution Google séparées par un point d'intersection.

Résumé de l'IA générative répété dans une liste

Lorsque vous répétez une présentation d'un résumé de lieu d'IA générative dans une liste d'emplacements:

Le contenu de la liste est attribué à Google
Les résumés affichés sont générés par IA
Contenu disponible auprès de Google

L'attribution doit être affichée au-dessus ou en dessous de la liste sur une seule ligne. L'attribution IA est alignée à gauche et l'attribution de Google à droite:

Dans le cas d'une liste, afficher l'attribution au-dessus ou en dessous de la liste sur une seule ligne.

Si des récapitulatifs plus longs de l'IA générative sont utilisés dans une liste, chacun d'eux doit être associé à l'IA ("Résumé par IA" avec l'icône ou le bouton d'informations).

Afficher des informations sur un résumé d'IA générative dans une boîte de dialogue

En plus d'un résumé pour l'IA générative, vous devez mettre à la disposition des utilisateurs finaux une boîte de dialogue contenant des informations sur le résumé et un lien pour signaler les problèmes. Lorsque vous utilisez un résumé de description d'IA générative, vous devez inclure des informations sur les sources du résumé, appelées references.

Activez l'accès à cette boîte de dialogue en incluant une icône d'informations (en tant qu'affordance d'interactivité) en conjonction avec l'attribution par l'IA (comme illustré dans les exemples ci-dessus) et en faisant en sorte que la zone et l'icône d'attribution IA répondent à une pression ou à un clic.

Pour les résumés génératifs des lieux, affichez les éléments suivants:

À propos	Les résumés de lieux basés sur l'IA sont générés à partir d'avis Google et d'autres données.
Signaler un problème	Pour signaler à Google un problème concernant le contenu d'un résumé, cliquez sur ce lien.
Références	Avis de source

Exemple :

Affichez des informations sur un résumé d'IA générative dans une boîte de dialogue.

Pour les résumés génératifs des zones, affichez les éléments suivants:

À propos	Les résumés des zones IA sont générés à partir d'avis Google et de données locales.
Signaler un problème	Pour signaler à Google un problème concernant le contenu d'un résumé, cliquez sur ce lien.

Attribution du résumé de la zone d'affichage.