Об API мест (новое)

Разработчики Европейской экономической зоны (ЕЭЗ)

Если ваш платёжный адрес находится в Европейской экономической зоне, то с 8 июля 2025 года к использованию вами Сервисов будут применяться Условия предоставления услуг платформы Google Карт для ЕЭЗ . Функциональность сервиса зависит от региона. Подробнее .

Введение

API Places (новый) включает в себя следующие API:

• Подробности места (новые)
• Фотографии места (новые)
• Поиск поблизости (новый)
• Текстовый поиск (новый)
• Автозаполнение (новое)

В этом документе содержится обзор этих новых API.

Подробности места (новые)

Идентификатор места однозначно идентифицирует место в базе данных Google Адресов и на Google Картах. С помощью идентификатора места вы можете запросить информацию о конкретном заведении или объекте интереса, отправив запрос «Сведения о месте (новое)» . Запрос «Сведения о месте (новое)» возвращает полную информацию об указанном месте, такую как его полный адрес, номер телефона, рейтинг пользователей и отзывы.

Примечание: Вы можете получить те же сведения о месте из Place Details (новая функция), что и из Text Search (новая функция) или Nearby Search (новая функция). Однако, если у вас уже есть идентификатор места, вызов Place Details (новая функция) обходится дешевле, чем вызов одного из поисковых API.

Существует множество способов получить идентификатор места. Вы можете использовать:

• Текстовый поиск (новый)
• Поиск поблизости (новый)
• API геокодирования
• API маршрутов
• API проверки адреса
• Автозаполнение (новое)

Фотографии места (новые)

Place Photos (новое) позволяет добавлять высококачественный фотоконтент в ваше приложение, предоставляя доступ к миллионам фотографий, хранящихся в базе данных Google Places. С помощью API Place Photos (новое) вы можете получить доступ к фотографиям и изменить размер изображения до оптимального для вашего приложения.

Все запросы к API Place Photos (New) должны включать имя фоторесурса, которое однозначно идентифицирует возвращаемую фотографию. Имя фоторесурса можно получить следующим образом:

• Подробности места (новые)
• Текстовый поиск (новый)
• Поиск поблизости (новый)

Чтобы включить название ресурса фотографии в ответ на запрос «Сведения о месте (новый)», «Текстовый поиск (новый)» или «Поиск поблизости (новый)», обязательно включите поле photos в маску поля запроса.

Текстовый поиск (новый) и поиск поблизости (новый)

API Places включает два поисковых API:

• Текстовый поиск (новый)

  Позволяет указать текстовую строку для поиска места. Например: «Острая вегетарианская еда в Сиднее, Австралия» или «Изысканные морепродукты рядом с Пало-Альто, Калифорния».

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

• Поиск поблизости (новый)

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

  Укажите один или несколько типов мест, определяющих их характеристики. Например, укажите « pizza_restaurant » и « shopping_mall », чтобы найти пиццерию, расположенную в торговом центре в указанном регионе.

Основное различие между этими двумя поисками заключается в том, что текстовый поиск (новый) позволяет указать произвольную строку поиска, тогда как поиск поблизости (новый) требует указания конкретной области, в которой будет выполняться поиск.

Автозаполнение (новое) и токены сеанса

Автозаполнение (новое) — это веб-сервис, который возвращает прогнозы мест и запросов в ответ на HTTP-запрос. В запросе укажите текстовую строку поиска и географические границы, определяющие область поиска.

Токены сеансов — это генерируемые пользователями строки, которые отслеживают вызовы функции автозаполнения (New) как сеансы. Функция автозаполнения (New) использует токены сеансов для группировки этапов запроса и выбора в процессе поиска с автозаполнением в отдельный сеанс для выставления счетов.

Новые поля, атрибуты и параметры доступности

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

Поля

API Places (новый) включает несколько новых полей:

Поле	Описание
regularSecondaryOpeningHours	Описывает конкретное время выполнения определённых операций. Дополнительные часы работы отличаются от основных часов работы предприятия. Например, ресторан может указать часы работы автокассы или доставки в качестве дополнительных часов.
paymentOptions	Варианты оплаты, принимаемые в заведении. Место может принимать несколько вариантов оплаты. Если данные о варианте оплаты недоступны, поле «Вариант оплаты» будет сброшено. Доступны следующие варианты: Кредитная карта Дебетовая карта Принимаем только наличные NFC-платеж
parkingOptions	На территории предусмотрены следующие варианты парковки: Бесплатные парковки Платные парковки Бесплатная парковка на улице Парковка с обслуживанием Бесплатная парковка в гараже Платная парковка в гараже
subDestinations	Уникальные места, связанные с определённым местом. Например, терминалы аэропорта считаются подпунктами назначения аэропорта.
fuelOptions	Актуальная информация о видах топлива, доступных на заправочной станции. Эта информация регулярно обновляется. Доступны следующие варианты: Дизель Обычный неэтилированный Средний класс Премиум СП91 СП91 Е10 СП92 СП95 Е10 СП98 СП99 СП100 сжиженный газ Е80 Е85 Метан Биодизель Дизельный грузовик
evChargeOptions	Количество зарядных устройств для электромобилей (ЭМ) на этой станции. Хотя некоторые зарядные устройства для электромобилей имеют несколько разъёмов, каждое зарядное устройство может заряжать только один автомобиль одновременно; поэтому в этом поле отображается количество доступных зарядных устройств для электромобилей в данный момент времени.
shortFormattedAddress	Короткий, понятный человеку адрес места.
primaryType	Основной тип результата. Например, место может быть классифицировано как cafe или airport . Место может иметь только один основной тип. Полный список возможных значений см. в разделе «Поддерживаемые типы» .
primaryTypeDisplayName	Отображаемое имя основного типа, локализованное на языке запроса, если применимо. Полный список возможных значений см. в разделе Поддерживаемые типы .

Атрибуты

API Places (новый) включает несколько новых атрибутов:

Атрибут	Описание
outdoorSeating	Место располагает местами для сидения на открытом воздухе.
liveMusic	В заведении звучит живая музыка.
menuForChildren	В заведении имеется детское меню.
servesCocktails	Здесь подают коктейли.
servesDessert	Здесь подают десерт.
servesCoffee	Здесь подают кофе.
goodForChildren	Место хорошее для детей.
allowsDogs	Место допускает собак.
restroom	В помещении есть туалет.
goodForGroups	Место рассчитано на группы.
goodForWatchingSports	Место подходит для просмотра спортивных состязаний.

Параметры доступности

API Places (новый) включает следующие поля параметров доступности:

Поле	Описание
wheelchairAccessibleParking	На территории предусмотрена парковка, доступная для инвалидных колясок.
wheelchairAccessibleEntrance	В помещении имеется вход, доступный для инвалидных колясок.
wheelchairAccessibleRestroom	В помещении имеется туалет, доступный для инвалидных колясок.
wheelchairAccessibleSeating	В помещении имеются места для сидения, подходящие для инвалидных колясок.

Сводки на основе искусственного интеллекта

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

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

Примечание: Все сводки, созданные с помощью ИИ, отображаемые в вашем приложении, должны сопровождаться соответствующей атрибуцией в соответствии с политиками и стандартами Google. Подробнее см. в разделе «Политики API Places» .

В API Places добавлены функции на базе искусственного интеллекта (новое)

Сводки на основе ИИ поддерживаются функциями Place Details (новое) , Text Search (новое) и Nearby Search (новое) . В ответах API Places (новое) доступны следующие сводки на основе ИИ:

• Краткие обзоры мест , представляющие собой краткие обзоры, относящиеся к определенному месту.
• Краткие обзоры , которые представляют собой краткие изложения того, что рецензенты сказали о том или ином месте.
• Обзоры районов , содержащие обзоры близлежащих и популярных мест в окрестностях. В их число входят обзоры районов и зарядных станций для электромобилей.

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

Попробуйте демо-версию сводок на основе искусственного интеллекта

Переход на новые API Places

Если вы являетесь существующим клиентом API Places (новым) и хотите перенести свое приложение для использования новых API, ознакомьтесь со следующей документацией по миграции:

• Перенести в сведения о месте (новое)
• Переход на функцию поиска поблизости (новый)
• Переход на текстовый поиск (новый)
• Перенести фотографии в место (новое)
• Переход на автозаполнение (новое)