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. Ils 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 faire une fois sur place.

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

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

    Le quartier 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-vous dans l'histoire littéraire à la librairie City Lights, découvrez la culture vibrante de Chinatown avec ses temples et ses usines de fortune cookies, ou remontez le temps au Cable Car Museum. Une variété de restaurants vous attendent, de la cuisine chinoise authentique à la délicieuse pizza."

Si vous envisagez de recharger un véhicule électrique, vous pouvez consulter un résumé généré pour une borne de recharge afin de trouver des cafés ou des restaurants à proximité où vous rendre pendant que vous attendez :

  • "Ce quartier propose un éventail de restaurants à moins de 9 minutes à pied, dont Starbucks, Sushi Jin et Safeway."

En plus d'une description du quartier, la réponse contient également une liste d'ID de lieux pour les lieux référencés dans la description.

L'API Places (nouveau) fournit deux types de résumés de zone basés sur l'IA :

  • Résumés de quartier, qui fournissent des aperçus généraux des attractions à proximité pour les lieux de type premise, street_address et tous les types des catégories Housing et Lodging.
  • Les résumés des équipements des bornes de recharge pour 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 basés sur l'IA sont compatibles avec Place Details (nouveau), Text Search (nouveau), et Nearby Search (nouveau).

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

Langue Région
Anglais États-Unis

Demander un résumé de quartier

Les résumés de quartier peuvent être générés pour les lieux de type premise, street_address, et tous les types des Housing (Logement) et Lodging (Hébergement) catégories. 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 :

  • Place Details (nouveau) : neighborhoodSummary
  • Text Search (nouveau) et Nearby Search (nouveau) : 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 les environs. Chaque sous-champ inclut une liste de noms de ressources de lieux référencés au format place/PLACE_ID.
  • Un flagContentUri lien où les utilisateurs peuvent signaler un problème avec le résumé généré.
  • Une chaîne de texte localisée avec le texte de divulgation "Résumé avec Gemini" qui doit être intégré dans les attributions.

L'exemple suivant demande un résumé de 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 comme suit :

{
  "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 équipements d'une borne de recharge pour véhicules électriques

Les résumés des équipements des bornes de recharge pour véhicules électriques peuvent être générés pour les lieux de type electric_vehicle_charging_station. Pour inclure le résumé des équipements d'une borne de recharge pour véhicules électriques dans la réponse, incluez les éléments suivants dans le masque de champ de votre requête :

  • Place Details (nouveau) : evChargeAmenitySummary
  • Text Search (nouveau) et Nearby Search (nouveau) : 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 de noms de ressources de lieux référencés au format place/PLACE_ID.
  • Un lien flagContentUri où les utilisateurs peuvent signaler un problème avec le résumé généré.
  • Une chaîne de texte localisée avec le texte de divulgation "Résumé avec Gemini" qui doit être intégré dans les attributions.

L'exemple suivant demande un résumé des équipements d'une borne de recharge pour véhicules électriques à 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 comme suit :

{
  "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 basés sur 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 de l'API Places API.