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

Des 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 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élange North Beach et Chinatown, se trouve au nord-ouest du Financial District. Il abrite des monuments littéraires, des attractions culturelles uniques et des restaurants variés. Parmi les lieux incontournables, on trouve la célèbre librairie City Lights, le fascinant Cable Car Museum 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 usines de biscuits chinois, ou remontez le temps au Cable Car Museum. Une variété d'options de restauration vous attend, de l'authentique cuisine chinoise à 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 de véhicules électriques afin de trouver des cafés ou des restaurants à proximité à visiter pendant que vous attendez :

  • "Ce quartier propose un large choix de restaurants à 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 lieux pour les lieux mentionnés dans la description.

La nouvelle API Places fournit deux types de résumés de zones optimisés par l'IA :

  • Les 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 commodités 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).

Demander un résumé du quartier

Les résumés de quartier peuvent être générés pour les lieux dont le type appartient aux 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 :

  • 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 les environs. Chaque sous-champ inclut une liste des noms de ressources de lieux référencés au format place/PLACE_ID.
  • Lien flagContentUri permettant aux utilisateurs de signaler un problème lié au résumé généré.
  • Chaîne de texte localisée avec le texte d'information "Résumé avec Gemini" qui doit être inclus dans les 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 équipements de recharge pour véhicules électriques

Des résumés des équipements des 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écapitulatif des équipements de recharge pour véhicules électriques dans la réponse, incluez les éléments suivants 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 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.
  • Lien flagContentUri permettant aux utilisateurs de signaler un problème lié au résumé généré.
  • Chaîne de texte localisée contenant le texte de divulgation "Résumé avec Gemini" qui doit être inclus dans les attributions.

L'exemple suivant demande un récapitulatif des équipements d'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 générés par 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.