Краткие пересказы областей на основе искусственного интеллекта

Сводки о районе, в котором находится место, создаются искусственным интеллектом. Сводки по районам предоставляют дополнительный контекст для местоположения, включая близлежащие достопримечательности, чтобы пользователи могли принять более обоснованное решение о том, куда пойти и что делать, когда они туда доберутся.

Например, если вы приехали в новый город, то можете посмотреть сгенерированное описание района, в котором находится отель, чтобы узнать больше об окрестностях.

  • "Этот оживленный район Сан-Франциско, объединяющий Норт-Бич и Чайнатаун, расположен к северо-западу от Финансового квартала и предлагает литературные достопримечательности, уникальные культурные объекты и разнообразные рестораны. Среди них – знаменитый книжный магазин City Lights, увлекательный Музей канатной дороги и оживленные улицы Чайна-тауна.

    Здесь вы найдете уникальное сочетание истории и культуры. Несмотря на холмы и толпы, район отлично подходит для пеших прогулок. Погрузитесь в литературную историю в книжном магазине City Lights, познакомьтесь с яркой культурой Чайнатауна с его храмами и фабриками печенья с предсказаниями или вернитесь в прошлое в Музее канатной дороги. Здесь можно попробовать самые разные блюда – от аутентичной китайской кухни до вкуснейшей пиццы".

Если вы хотите зарядить электромобиль, то можете посмотреть сводку по станции зарядки электромобилей, чтобы найти поблизости кафе или рестораны, где можно подождать:

  • "В этом районе есть несколько ресторанов в пределах 9 минут ходьбы, в том числе Starbucks, Sushi Jin и Safeway".

Вместе с описанием области ответ также содержит список идентификаторов мест, упомянутых в описании.

Places API (новинка) предоставляет два типа сводок по областям на основе искусственного интеллекта:

  • Сводки по району – общие сведения о близлежащих достопримечательностях для мест типов premise, street_address и всех типов в категориях Жилье и Размещение.
  • Сводки об удобствах на станциях зарядки электромобилей (EVCS), которые содержат общие сведения о близлежащих достопримечательностях для мест с типом electric_vehicle_charging_station.

Сводки по областям на основе искусственного интеллекта поддерживаются в информации о местах (новая версия), текстовом поиске (новая версия) и поиске поблизости (новая версия).

Сводки по областям поддерживаются для объектов инфраструктуры на следующих языках и в следующих регионах:

Язык Регион
Английский США

Запросите сводку по району

Краткие описания районов можно создавать для мест с типами premise, street_address и всеми типами в категориях Жилье и Проживание. Чтобы в ответе возвращалась сводка по району, включите в маску поля запроса следующее:

  • Place Details (New): neighborhoodSummary
  • Текстовый поиск (новый) и Поиск поблизости (новый): places.neighborhoodSummary

Поле neighborhoodSummary для места в ответе содержит следующее:

  • Два вложенных поля: overview и description. Подполе overview содержит информацию о близлежащих объектах инфраструктуры, а подполе description – общие сведения о районе. Каждое подполе содержит список названий ресурсов мест в формате place/PLACE_ID.
  • Ссылка flagContentUri, по которой пользователи могут сообщить о проблеме с созданным пересказом.
  • Локализованная текстовая строка с текстом "Пересказано с помощью Gemini", которую необходимо включить в атрибуцию.

В следующем примере запрашивается сводка по району для отеля в Нью-Йорке:

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'

Ответ имеет следующий вид:

{
  "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"
    }
  }
}

Запросить сводку по зарядным станциям для электромобилей

Сводки удобств для станций зарядки электромобилей (EVCS) можно генерировать для мест с типом electric_vehicle_charging_station. Чтобы включить в ответ сводку по удобствам зарядной станции, добавьте в маску поля запроса следующее:

  • Place Details (New): evChargeAmenitySummary
  • Текстовый поиск (новый) и Поиск поблизости (новый): places.evChargeAmenitySummary

Поле evChargeAmenitySummary для места в ответе содержит следующее:

  • Четыре подполя: overview, coffee, restaurant и store. Каждое подполе содержит краткое описание ближайших объектов инфраструктуры и список названий ресурсов мест в формате place/PLACE_ID.
  • Ссылка flagContentUri, по которой пользователи могут сообщить о проблеме с созданным пересказом.
  • Локализованная текстовая строка с текстом "Пересказано с помощью Gemini", которую необходимо включить в атрибуцию.

В следующем примере запрашивается сводка по удобствам на станции зарядки ЭМ в Маунтин-Вью:

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'

Ответ имеет следующий вид:

{
  "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"
    }
  }
}

Атрибуции

Все сводки на основе искусственного интеллекта, показанные в вашем приложении, должны сопровождаться указанием авторства в соответствии с правилами и стандартами Google. Подробную информацию можно найти в правилах Places API.