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

Des résumés de zone basés sur l'IA sont générés pour la zone entourant un lieu. Les récapitulatifs de zone fournissent un contexte supplémentaire sur un lieu, y compris les points d'intérêt à proximité, afin que les utilisateurs puissent prendre une décision plus éclairée sur les endroits à visiter et les activités à découvrir une fois sur place.

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

  • "Ce quartier animé de San Francisco, qui mêle North Beach et Chinatown, se trouve au nord-ouest du Financial District. Il abrite des sites littéraires, des attractions culturelles uniques et une offre culinaire variée. Parmi les sites remarquables figurent l'emblématique librairie City Lights, le fascinant Cable Car Museum et les rues animées de Chinatown.

    Cette région offre un mélange unique d'histoire et de culture, où un environnement adapté aux piétons invite à l'exploration malgré quelques collines et la foule. Immergez-vous dans l'histoire littéraire à la librairie City Lights, découvrez la culture dynamique de Chinatown avec ses temples et ses usines de biscuits porte-bonheur, ou remontez le temps au Cable Car Museum. Vous trouverez de nombreuses 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 pourrez vous rendre pendant l'attente :

  • "Ce quartier propose de nombreux restaurants à moins de neuf 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) propose deux types de récapitulatifs d'informations sur une zone, basés sur l'IA :

  • Résumés de quartier, qui fournissent une vue d'ensemble des attractions à proximité pour les lieux de type 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 une vue d'ensemble des attractions à proximité pour les lieux de type electric_vehicle_charging_station.

Les récapitulatifs d'informations sur les zones optimisés par l'IA sont disponibles dans Place Details (New) (Informations sur le lieu (nouvelle version)), Text Search (New) (Recherche textuelle (nouvelle version)) et Nearby Search (New) (Recherche à proximité (nouvelle version)).

Demander un résumé de quartier

Vous pouvez générer des récapitulatifs de quartier pour les lieux dont le type appartient aux catégories Logement et Hébergement. Pour renvoyer un résumé de quartier dans la réponse, incluez les éléments suivants dans le masque de champ de votre requête :

  • Détails du lieu (nouveau) : neighborhoodSummary
  • Text Search (nouvelle version) et Nearby Search (nouvelle version) : 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 des noms de ressources de lieu référencés au format place/PLACE_ID.
  • Lien flagContentUri permettant aux utilisateurs de signaler un problème avec le résumé généré.
  • Chaîne de texte localisée avec le texte d'information "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 d'un EVCS

Des récapitulatifs des services de bornes de recharge de véhicules électriques peuvent être générés pour les lieux de type electric_vehicle_charging_station. Pour inclure le résumé des services EVCS dans la réponse, incluez ce qui suit dans le masque de champ de votre requête :

  • Détails du lieu (nouveau) : evChargeAmenitySummary
  • Text Search (nouvelle version) et Nearby Search (nouvelle version) : 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 comprend une brève description des points d'intérêt à proximité et une liste des noms de ressources de lieu référencés sous la forme place/PLACE_ID.
  • Lien flagContentUri permettant aux utilisateurs de signaler un problème avec le résumé généré.
  • Chaîne de texte localisée avec le texte d'information "Résumé avec Gemini" qui doit être intégré aux attributions.

L'exemple suivant demande un résumé des services proposés par une borne de recharge de 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 les Règles concernant l'API Places.