API геокодирования предоставляет сгенерированные искусственным интеллектом сводные данные, помогающие пользователям понять особенности пункта назначения. Эти сводные данные предоставляются в объекте Destination в поле arrivalSummary .
Эти краткие, легко читаемые текстовые фрагменты объемом около 120 символов или 24 слов не более, которые описывают отличительные особенности места назначения и помогают пользователям при планировании поездки и прибытии.
Например:
- "За пиццерией Domino's ⋅ Многоэтажный жилой дом с белыми и кирпично-красными полосами ⋅ Вход за черными металлическими воротами"
- «Высокий многоквартирный дом кремового цвета с балконами. Вход расположен под большим арочным мостом над подъездной дорогой и оборудован постом охраны».
Сводные данные о прибытии генерируются искусственным интеллектом. Однако эти сводки являются экспериментальными и могут иногда содержать неточную информацию. Вашим пользователям не следует полагаться на сводки, созданные с помощью ИИ, как на источник информации.
Запросить сводку о прибытии
Чтобы получить сводку о прибытиях в ответе, добавьте destinations.arrivalSummary в заголовок X-Goog-FieldMask вашего запроса на поиск пунктов назначения :
curl -X POST -d '{ "place": "places/ChIJAWLGeHRZwokRV4Dojw9TEHA" }' \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: destinations.arrivalSummary" \ https://geocode.googleapis.com/v4alpha/geocode/destinations
Поле arrival_summary содержит объект ArrivalSummary со следующими полями: text , flag_content_url и disclosure_text .
Ответ представлен в следующем виде:
{ "destinations": [ { "arrivalSummary": { "text": { "text": "Tall red-brick apartment building ⋅ Entrance has a glass front and a grey metal overhang", "languageCode": "en" }, "flagContentUrl": "https://www.google.com/local/review/rap/report?postId=...", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } } ] }
Отображение сводных данных, созданных с помощью ИИ.
При отображении сводок, созданных с помощью ИИ, в вашем приложении необходимо включить обязательный текст с предупреждением и ссылку для сообщения о проблемах со сводкой.
Текст уведомления
При отображении сводки, созданной с помощью ИИ на основе text поля, необходимо включить локализованный текст уведомления, предоставленный в поле disclosure_text объекта ArrivalSummary , в ответ непосредственно под сводкой. Никогда не изменяйте и не дополняйте текст уведомления, предоставленный API.
Сообщить о проблемах
Каждое краткое описание содержит параметр flag_content_url , который предоставляет пользователям ссылку для сообщения о проблемах с содержимым описания. При отображении краткого описания, созданного с помощью ИИ, необходимо сделать эту ссылку доступной для пользователей, чтобы они могли сообщать о проблемах с описанием.
Для получения более подробной информации см. раздел «Политика использования API геокодирования» .
Покрытие по пунктам назначения
Сводные данные, созданные с помощью искусственного интеллекта, доступны только для населенных пунктов, расположенных в следующих крупных городах:
Соединенные Штаты
- Атланта
- Бостон
- Чикаго
- Даллас-Форт-Уэрт
- Хьюстон
- Лас-Вегас
- Лос-Анджелес
- Майами
- Нью-Йорк
- Филадельфия
- Сан-Диего
- Сан-Франциско
- Сиэтл
- Вашингтон, округ Колумбия
Индия
- Бангалор (Бенгалуру)
- Ченнаи
- Дели (Нью-Дели)
- Хайдерабад
- Колката
- Мумбаи
Обратная связь
Это экспериментальная функция API геокодирования. Будем благодарны за отзывы, отправленные по адресу geocoding-feedback-channel@google.com .