Сводки по местности, созданные с помощью искусственного интеллекта, позволяют получить дополнительную информацию о местности, включая информацию о достопримечательностях поблизости, что позволяет пользователям принимать более обоснованные решения о том, куда идти и что делать по прибытии.
Например, при посещении нового города вы можете просмотреть сформированную сводку по окрестностям отеля, чтобы узнать больше о нем:
Этот оживлённый район Сан-Франциско, сочетающий в себе Норт-Бич и Чайнатаун, расположен к северо-западу от Финансового квартала и славится литературными памятниками, уникальными культурными достопримечательностями и разнообразными ресторанами. Среди примечательных мест — знаменитый книжный магазин City Lights, увлекательный Музей канатных трамваев и оживлённые улицы Чайнатауна.
Этот район предлагает уникальное сочетание истории и культуры: пешеходная зона, удобная для исследования, несмотря на холмы и толпы, располагает к знакомству с городом. Погрузитесь в историю литературы в книжном магазине City Lights, окунитесь в яркую культуру Чайнатауна с его храмами и фабриками печенья с предсказаниями или совершите путешествие в прошлое в Музее канатного трамвая. Вас ждет широкий выбор ресторанов, от аутентичной китайской кухни до восхитительной пиццы.
Если вы планируете зарядить электромобиль, вы можете просмотреть сформированную сводку по станциям зарядки электромобилей, чтобы найти ближайшие кафе и рестораны, которые можно посетить, пока вы ждете:
- «В этом районе в 9 минутах ходьбы расположено множество заведений общественного питания, включая Starbucks, Sushi Jin и Safeway».
Наряду с описанием местности ответ также содержит список идентификаторов мест, упомянутых в описании.
API мест (новый) предоставляет два типа сводок по местности на основе ИИ:
- Сводки по окрестностям , которые предоставляют общие сведения о близлежащих достопримечательностях для мест с типами
premise
,street_address
, а также всех типов в категориях « жилье» и «проживание» . - Краткие сведения об удобствах станций зарядки электромобилей (EVCS) , которые содержат общие обзоры близлежащих достопримечательностей для мест с типом
electric_vehicle_charging_station
.
Сводки по местности на основе искусственного интеллекта поддерживаются в сведениях о месте (новое) , текстовом поиске (новое) и поиске поблизости (новое) .
Запросить сводку по району
Сводки по районам можно создавать для объектов типа premise
, street_address
и всех типов в категориях Housing и Lodging . Чтобы получить сводку по районам в ответе, включите в маску поля запроса следующее:
- Подробности места (новые):
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 upscaleboutiques, designer shops, and thriving art scene. The area is home to the Color , "languageCode": "en-US" }, "referencedPlaces": [ "places/ChIJZd0F3oxZwokRiaEouMZKQ-0", /.../ ] }, "description": { "content": { "text": "SoHo's walkability and convenient public transportation options make exploration easy. A diverse arrayFactory and Dominique Ansel Bakery, known for its popular Cronuts." of restaurants and cafes cater to varied tastes. SoHo's central location, , "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" } } }surrounded by vibrant neighborhoods, contributes to its fast-paced and energetic atmosphere, with a focus on fashion and design."
Запросить сводку удобств EVCS
Сводки по удобствам станций зарядки электромобилей (EVCS) можно создавать для объектов типа electric_vehicle_charging_station
. Чтобы включить сводку по удобствам EVCS в ответ, добавьте в маску поля запроса следующее:
- Подробности места (новые):
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 CoffeeRoasting 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-backatmosphere." , "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 servesclassic Japanese dishes, including vegetarian and healthy options.\nSubway is a chain sandwich shop , "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" } } }offering its usual subs, wraps, and salads."
Атрибуции
Все сводки, созданные с помощью ИИ, отображаемые в вашем приложении, должны сопровождаться соответствующей атрибуцией в соответствии с политиками и стандартами Google. Подробнее см. в разделе «Политики API Places» .