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

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

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

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

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

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

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

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

Новая версия Places API предоставляет два типа кратких описаний областей, созданных на основе ИИ:

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

Сводки на основе ИИ поддерживаются в Place Details (New), Text Search (New) и Nearby Search (New).

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

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

Как запросить краткую информацию о районе

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

  • Информация о местах (новые): 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. Чтобы включить в ответ сводку удобств EVCS, добавьте в маску поля запроса следующее:

  • 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. Подробнее о правилах в отношении API Мест…