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, ce qui vous permet de 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 recherche textuelle (nouvelle version) standard pour "bornes de recharge de VE" renvoie une liste de lieux proposant des bornes de recharge de VE. Ce type de réponse convient si vous recherchez simplement la borne de recharge de VE le plus proche ou celle compatible avec votre véhicule le plus proche.

Mais vous voudrez peut-être aussi mieux comprendre la zone autour de la borne de recharge, en particulier si vous devez être là pendant une heure ou plus pendant que votre véhicule est en charge. Lorsque vous utilisez les capacité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 indiqué, y compris des informations sur la zone autour de la borne de recharge:

  • « En 2 à 4 minutes à pied, plusieurs options de restauration et de shopping s'offrent à vous, dont Chef Chu's, Gen Korean Barbecue House, Amber India, Pacific Catch, ainsi que plusieurs épiceries telles que Walmart, Whole Foods Market et Trader Joe's. »

  • "À moins de 1-5 minutes à pied, plusieurs restaurants et boutiques se trouvent, dont la Khao Kang Thai Kitchen, le Roger's Deli & Donuts et La Costeña. Joy Sushi est parfait pour les sushis. Pour les produits alimentaires, Dollar Tree offre une variété de produits à prix réduits. »

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 (nouvelle version) :

Résumés génératifs de 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) propose deux types de résumés génératifs de lieux:

  • Résumés de l'aperçu: bref aperçu d'un lieu (environ 100 caractères en moyenne) qui peut aider les utilisateurs à obtenir un aperçu du lieu.

  • Résumés des descriptions: résumés plus longs d'un lieu (environ 400 caractères en moyenne) qui offrent une vue d'ensemble détaillée des principaux caractéristiques du lieu.

Les résumés de lieux sont actuellement disponibles pour les types de lieux affichés dans Types acceptés pour les catégories Culture, Divertissement et loisirs, Alimentation et boissons, Shopping et Sports.

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

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

En plus d'une description de la zone, la réponse contient également une liste d'identifiants de lieux pour les lieux référencés dans la description, ainsi qu'une liste de lieux triés par différents types de contenu. 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.

Les résumés de zones sont actuellement disponibles pour les types de lieux affichés dans Types acceptés 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 de lieux et de zones sont fréquemment générés hors connexion par Google. En générant ces résumés hors connexion, vous pouvez profiter du contenu fourni par Gemini tout en conservant les performances attendues avec l'API Places (nouvelle version).

Google génère fréquemment ces résumés à nouveau pour s'assurer qu'ils sont à jour et basés sur les dernières informations disponibles. Cela signifie que vous allez afficher les données les plus récentes de votre service lorsque vous appelez l'API.

Résultats de recherche contextuels

Text Search (nouvelle version) renvoie des informations sur un ensemble de lieux en fonction d'une chaîne, par exemple "pizza à New York" ou "magasin de chaussures près d'Ottawa". La réponse de Text Search (nouvelle version) contient une liste de 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 à proximité (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 requête Text Search (nouvelle version) 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 contextuels 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é à Paris"

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

"Restaurant végan épicé à Paris"

Pour un restaurant qui apparaît dans les deux réponses, les données de réponse sur le lieu sont les mêmes, car elles sont associées au lieu lui-même. Toutefois, les résultats de recherche contextuels 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, photos et justifications issus des résultats de recherche contextuels pour les aider à choisir l'emplacement de la réponse le plus adapté à leur requête de recherche.

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

Vous devez activer l'API Places (nouvelle version) afin d'utiliser les fonctionnalités des modèles Gemini pour cette API. 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 (en anglais uniquement) pour les lieux situés aux États-Unis.

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 pour un lieu

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 : résumés génératifs semblables au résumé éditorial statique associé à un lieu. Les résumés courts génératifs (environ 100 caractères en moyenne) présentent plusieurs avantages:

    • De nombreux établissements n'ont pas de résumés éditoriaux. Ils comblent donc une lacune dans les informations disponibles.

    • Comme elles sont générées à partir du LLM, le propriétaire du lieu n'a pas besoin de les gérer.

  • Les résumés génératifs de type Description sont dérivés de nombreuses sources, y compris les avis issus de Google Maps. La description, d'environ 400 caractères en moyenne, inclut une liste d'avis utilisés pour 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 capacité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 (nouvelle version), Text Search (nouvelle version) et Nearby Search (nouvelle version). Pour inclure le résumé du lieu 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 l'aperçu génératif
  • generativeSummary.description: résumé de la description générative
  • generativeSummary.references: tableau comportant jusqu'à cinq avis permettant de fournir du contenu pour le 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 de résumé de la vue d'ensemble

Cet exemple Text Search ne renvoie que le résumé overview pour les restaurants végétariens épicés de 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 requête de résumé et de description

Cet exemple exécute la même requête que dans l'exemple précédent, mais utilise un masque de champ 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é génératif de zones

Les résumés de zones sont des résumés génératifs créés par le LLM pour la zone voisine d'un lieu. Les résumés de zones peuvent aider les utilisateurs à prendre une décision concernant un lieu.

Par exemple, vous souhaitez réserver un hôtel dans une nouvelle ville et, même si vous trouvez un hôtel qui répond à vos critères, vous souhaitez également en savoir plus sur les environs de l'hôtel. Plutôt que d'examiner une carte des environs et de devoir examiner chaque lieu sur la carte, vous pouvez générer un résumé des zones de l'hôtel.

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

Pour inclure le résumé de zone 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 est basé sur le type de lieu:

  • Pour une borne de recharge de VE, définie comme un lieu de type electric_vehicle_charging_station, les blocs thématiques incluent: "overview", "coffee", "restaurant" et "store".

  • Pour un lieu dont le type est défini par la catégorie Hébergement, et pour les types de lieu spécifiques geocode et premise, les blocs thématiques incluent: "overview", "activity", "restaurant" et "store".

Exemple de requête pour un 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 pour 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 indique le type de bloc de contenu. Étant donné que le lieu présenté 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 de 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 la zone pour un hôtel

Cet exemple de requête Text Search demande 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 adressée à 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 du tableau en tant qu'emplacement dans le tableau places. Autrement dit, l'élément situé à contextualContents[0] correspond au lieu situé à l'emplacement places[0].

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

  • contextualContents.reviews: tableau contenant jusqu'à trois avis.
  • contextualContents.photos: tableau contenant jusqu'à cinq photos.
  • contextualContents.justifications: tableau de justifications du lieu, y compris:

    • reviewJustification: met en évidence une section d'un avis d'utilisateur qui pourrait intéresser un utilisateur final.
    • businessAvailabilityAttributesJustification : inclut les attributs d'une entreprise susceptibles d'intéresser un utilisateur final.

Pour inclure les résultats de recherche contextuels dans la réponse, ajoutez 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é des conducteurs, Google recommande d'afficher les résumés de l'IA générative en mode de stationnement pour les expériences en voiture. Si vous affichez les résumés en mode Voiture, les informations affichées à l'écran doivent être simples, claires et concises pour que l'attention du conducteur soit de retour rapidement sur la route.

  • Trois lignes maximum
  • 120 caractères ou 24 mots maximum
  • Taille minimale de l'avant de 24 dp

Il est de la responsabilité du développeur d'afficher des résumés d'IA générative de manière sécurisée et conforme à l'ensemble des lois et règlements locaux, en particulier dans le contexte du secteur automobile.

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 également veiller à afficher les attributions 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, l'attribution doit utiliser une majuscule en début de phrase. La mention d'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 de 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 par IA générative peut s'afficher seule au-dessus ou en dessous du résumé, en s'appuyant sur l'attribution par Google du contenu ailleurs.

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

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

Affichage isolé du résumé de l'IA générative

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

Pour que le récapitulatif soit affiché de manière isolée, incluez l'attribution par IA générative et l'attribution Google en les séparant par un trait.

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

Lorsque vous répétez une présentation récapitulative de l'IA générative dans une liste de lieux, où tous:

  • 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 s'afficher au-dessus ou en dessous de la liste sur une seule ligne. L'attribution IA est alignée à gauche et celle de Google est alignée à droite:

Pour une liste, affichez l'attribution au-dessus ou en dessous de la liste sur une seule ligne.

Si des résumés de descriptions d'IA générative plus longs sont utilisés dans une liste, chaque résumé doit avoir une attribution par IA ("Résumé par l'IA" à l'aide de l'icône/du bouton d'informations).

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

En plus d'un résumé généré par 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 des 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'information (en tant qu'affordance d'interactivité) avec l'attribution 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 à un appui ou à un clic.

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

À propos Les résumés de lieux générés par IA sont générés à partir des 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 sur la source

Exemple :

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

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

À propos Les résumés par IA sont générés à partir des avis Google et des 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 récapitulative de la zone d'affichage.