Résumés de zone optimisés par l'IA

Les résumés de zone optimisés par l'IA sont générés pour la zone entourant un lieu. Les résumés de zone fournissent un contexte supplémentaire pour un lieu, y compris les points d'intérêt à proximité, afin que les utilisateurs puissent prendre une décision plus éclairée sur l'endroit où aller et ce qu'ils peuvent y faire.

Par exemple, lorsque vous visitez une nouvelle ville, vous pouvez afficher un résumé généré du quartier d'un hôtel pour en savoir plus sur les environs :

  • "Ce quartier dynamique de San Francisco, qui mêle North Beach et Chinatown, se trouve au nord-ouest du Financial District. Il abrite des monuments littéraires, des attractions culturelles uniques et une grande variété de restaurants. Parmi les lieux incontournables, citons la célèbre librairie City Lights, le fascinant musée des Cable Cars et les rues animées de Chinatown.

    La région offre un mélange unique d'histoire et de culture, où un environnement piétonnier invite à l'exploration malgré quelques collines et la foule. Plongez dans l'histoire littéraire à la librairie City Lights, découvrez la culture dynamique de Chinatown avec ses temples et ses fabriques de biscuits de fortune, ou remontez le temps au musée du téléphérique. Vous pourrez profiter d'une variété d'options de restauration, de la cuisine chinoise authentique aux délicieuses pizzas."

Si vous envisagez de recharger un véhicule électrique, vous pouvez afficher un résumé généré pour une borne de recharge de véhicules électriques afin de trouver des cafés ou des restaurants à proximité où vous rendre en attendant :

  • "Ce quartier propose plusieurs options de restauration à moins de 9 minutes à pied, dont Starbucks, Sushi Jin et Safeway."

En plus d'une 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.

L'API Places (nouvelle version) fournit deux types de résumés de zone optimisés par l'IA :

  • Résumés de quartier, qui fournissent des aperçus généraux des attractions à proximité pour les lieux de types premise, street_address et tous les types des catégories Logement et Hébergement.
  • Résumés des services des bornes de recharge de véhicules électriques, qui fournissent des aperçus généraux des attractions à proximité pour les lieux de type electric_vehicle_charging_station.

Les résumés de zone optimisés par l'IA sont disponibles dans Place Details (New), Text Search (New) et Nearby Search (New).

Les résumés de zone sont disponibles pour les points d'intérêt dans les langues et régions suivantes :

Langue Région
Anglais États-Unis

Demander un résumé d'un quartier

Les résumés de quartier peuvent être générés pour les lieux de types premise, street_address et tous les types des catégories Logement et Hébergement. Pour renvoyer un résumé du quartier dans la réponse, incluez les éléments suivants dans le masque de champ de votre requête :

  • Place Details (New) : neighborhoodSummary
  • Text Search (New) et Nearby Search (New) : places.neighborhoodSummary

Le champ neighborhoodSummary d'un lieu dans la réponse contient les éléments suivants :

  • Deux sous-champs : overview et description. Le sous-champ overview inclut les points d'intérêt à proximité spécifiques au lieu, tandis que le sous-champ description fournit des informations plus générales sur la zone environnante. Chaque sous-champ inclut une liste de noms de ressources de lieu référencés au format place/PLACE_ID.
  • Un lien flagContentUri permettant aux utilisateurs de signaler un problème concernant le résumé généré.
  • Chaîne de texte localisée avec le texte de divulgation "Résumé avec Gemini" qui doit être intégré aux attributions.

L'exemple suivant demande un résumé du quartier pour un hôtel à New York :

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

La réponse se présente sous la forme suivante :

{
  "id": "ChIJT0DdRo1ZwokRkufwSD-TdGM",
  "displayName": {
    "text": "Courtyard New York Manhattan/SoHo",
    "languageCode": "en"
  }
  "neighborhoodSummary": {
    "overview": {
      "content": {
        "text": "This area resides within SoHo, a trendy Lower Manhattan neighborhood celebrated for its upscale boutiques, designer shops, and thriving art scene. The area is home to the Color Factory and Dominique Ansel Bakery, known for its popular Cronuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "description": {
      "content": {
        "text": "SoHo's walkability and convenient public transportation options make exploration easy. A diverse array of restaurants and cafes cater to varied tastes. SoHo's central location, surrounded by vibrant neighborhoods, contributes to its fast-paced and energetic atmosphere, with a focus on fashion and design.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=&d=17924085&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Demander un résumé des services de recharge de VE

Des résumés des équipements des bornes de recharge de véhicules électriques (EVCS) peuvent être générés pour les lieux de type electric_vehicle_charging_station. Pour inclure le récapitulatif des services de recharge de VE dans la réponse, incluez les éléments suivants dans le masque de champ de votre requête :

  • Place Details (New) : evChargeAmenitySummary
  • Text Search (New) et Nearby Search (New) : places.evChargeAmenitySummary

Le champ evChargeAmenitySummary d'un lieu dans la réponse contient les éléments suivants :

  • Quatre sous-champs : overview, coffee, restaurant et store. Chaque sous-champ inclut une brève description des points d'intérêt à proximité et une liste des noms de ressources de lieux référencés au format place/PLACE_ID.
  • Un lien flagContentUri permettant aux utilisateurs de signaler un problème concernant le résumé généré.
  • Chaîne de texte localisée avec le texte de divulgation "Résumé avec Gemini" qui doit être intégré aux attributions.

L'exemple suivant demande un résumé des services d'une borne de recharge VE à Mountain View :

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

La réponse se présente sous la forme suivante :

{
  "id": "ChIJf8j-4z23j4AR_MQ2-bgMmrY",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "evChargeAmenitySummary": {
    "overview": {
      "content": {
        "text": "Within a short walk, there are several coffee and restaurant options, including Clocktower Coffee Roasting Company, Khao Kang Thai Kitchen, and Roger's Deli & Donuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q",
        /.../
      ]
    },
    "coffee": {
      "content": {
        "text": "Clocktower Coffee Roasting Company has Wi-Fi and a variety of coffee and pastries in a laid-back atmosphere.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q"
      ]
    },
    "restaurant": {
      "content": {
        "text": "Roger's Deli & Donuts is a bustling deli with sandwiches and breakfast items.\nJoy Sushi serves classic Japanese dishes, including vegetarian and healthy options.\nSubway is a chain sandwich shop offering its usual subs, wraps, and salads.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJQ4F3PBa3j4ARf7_QjN1Cklo",
        /.../
      ]
    },
    "store": {
      "content": {
        "text": "Rotten Robbie is a chain gas station with a convenience store and a restroom.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJA6deFBa3j4AREY0EyTEGhN8",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ABCDEFG=1234567&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Attributions

Tous les résumés optimisés par l'IA affichés dans votre application doivent être accompagnés de l'attribution appropriée, conformément aux règles et normes de Google. Pour en savoir plus, consultez Règles de l'API Places.