Places API поддерживает две версии API: Places API — это существующие API, а Places API (новый) — это версия API следующего поколения.
С выпуском Places API (нового) ваша первая задача — решить, какой набор API использовать. Это верно, если вы новый клиент или существующий клиент, уже использующий API. Используйте это руководство, чтобы понять ключевые различия между двумя API.
Список API
В следующей таблице перечислены оба набора API. Если вы уже являетесь клиентом, используйте эту таблицу, чтобы определить новый API, который заменит API, который вы используете в настоящее время.
| API мест | API мест (новое) | Примечание |
|---|---|---|
| Найти место | Текстовый поиск (новинка) | Новой версии Find Place не существует. Текстовый поиск (новый) заменил его. |
| Поиск поблизости | Поиск поблизости (новинка) | Все запросы с использованием существующего API, включающие текстовый запрос, должны использовать текстовый поиск (новый), поскольку поиск поблизости (новый) не поддерживает ввод текста. |
| Текстовый поиск | Текстовый поиск (новинка) | |
| Детали места | Детали места (новое) | |
| Разместить фото | Разместить фото (новое) | |
| Разместить автозаполнение | Автозаполнение (новое) | |
| Автозаполнение запроса | Автозаполнение (новое) | Возможности, добавленные в автозаполнение (новое) |
Версия службы Places API, которую вы включаете в своем ключе API, управляет API, используемыми вашим приложением:
Places API : включает существующие API. Если для проекта, связанного с ключом API, используемым для вашего приложения, включен только Places API, ваше приложение не будет иметь доступа к новым API.
Places API (новое) . Включает все новые API и функции, описанные в разделе «Основные функции, добавленные в Places SDK для iOS (новое)» . Ваше приложение не будет иметь доступа к существующим API.
Оба : включает все функции и API для Places SDK для iOS (новая версия) и Places SDK для iOS .
Дополнительную информацию о выборе службы Places API см. в разделе Настройка проекта Google Cloud .
Переход на новые API
Если вы используете существующий API и хотите перейти на новый API, ознакомьтесь со следующими руководствами по миграции для каждого API:
- Переход на поиск поблизости (новинка)
- Переход на текстовый поиск (новинка)
- Перенос в сведения о месте (новинка)
- Миграция для размещения фотографии (новая версия)
- Переход на автозаполнение (новое)
Ключевые функции, добавленные в Places API (новинка)
В этом разделе описаны ключевые функции, добавленные в Places API (новая версия).
Реализовано на стандартной платформе Google Cloud.
Places API (новый) реализован в сервисной инфраструктуре Google Cloud. Эта реализация обеспечивает более безопасную и надежную платформу с расширенными возможностями безопасности, такими как OAuth . Этот стандартный дизайн API обеспечивает уровень согласованности между API, что повышает эффективность разработки с помощью Places API (новая версия).
Улучшенная производительность
API Places (новый) обеспечивает повышенную производительность, поэтому стоит заменить приложения, использующие существующий API Places.
Упрощенное ценообразование
Ценообразование упрощено благодаря Places API (новое), поэтому вы платите только за те данные, которые используете. Упрощенное ценообразование реализуется с помощью маски поля .
При использовании сведений о месте (новое), поиска поблизости (новое) и текстового поиска (новое) вы используете маску поля для управления списком полей, возвращаемых в ответе. В этом случае вам будет выставлен счет только за запрошенные данные. Использование маскировки полей — это хорошая практика проектирования, позволяющая гарантировать, что вы не запрашиваете ненужные данные, что помогает избежать ненужного времени обработки и затрат на выставление счетов.
Согласованные данные ответов для места
При использовании существующих API API сведений о месте, поиска поблизости и текстового поиска возвращали разные данные ответа для места. Places API (новый) стандартизирует ответ, поэтому все эти API возвращают одни и те же данные о месте.
Расширенные типы мест
Ответ API теперь может содержать основной тип места. Каждое место может иметь одно значение типа, указанное в качестве основного типа места, как указано в таблице A.
Кроме того, новый API добавляет типы мест, показанные в таблице ниже. Вы можете использовать эти новые и существующие типы при поиске с помощью поиска по соседству (новое) и текстового поиска (новое). Все новые типы включены в Таблицу А.
| Тип | |||
|---|---|---|---|
| американский_ресторан | скидка_магазин | Ice_cream_shop | сэндвич_магазин |
| центр развлечений | собака_парк | индийский_ресторан | школьный_район |
| спортивное_поле | electric_vehicle_charging_station | индонезийский_ресторан | ресторан_морепродуктов |
| auto_parts_store | событие_место проведения | итальянский_ресторан | лыжный_курорт |
| банкетный_зал | Extended_stay_hotel | японский_ресторан | испанский_ресторан |
| барбекю_ресторан | ферма | корейский_ресторан | магазин_спортивных_товаров |
| парикмахерская | проживание на ферме | lebanese_restaurant | спортивный_клуб |
| кровать_и_завтрак | fast_food_restaurant | пристань для яхт | спортивный_комплекс |
| бразильский_ресторан | паромный_терминал | рынок | стейк_хаус |
| завтрак_ресторан | фитнес_центр | медицинская_лаборатория | суши_ресторан |
| бранч_ресторан | французский_ресторан | средиземноморский_ресторан | бассейн |
| автобусная_остановка | магазин подарков | мексиканский_ресторан | портной |
| кемпинг_кабина | поле для гольфа | middle_eastern_restaurant | поставщик_телекоммуникационных_услуг |
| cell_phone_store | греческий_ресторан | мотель | тайский_ресторан |
| child_care_agency | продуктовый магазин | национальный_парк | транзит_депо |
| китайский_ресторан | гостевой дом | park_and_ride | грузовик_стоп |
| кофейный магазин | парикмахерский_салон | театр_исполнительского_искусства | турецкий_ресторан |
| центр_сообщества | гамбургер_ресторан | пицца_ресторан | веганский_ресторан |
| консультант | вертолетная площадка | детская площадка | вегетарианский_ресторан |
| конференц-центр | зона походов | дошкольный | вьетнамский_ресторан |
| коттедж | исторический_ориентир | Private_guest_room | посетитель_центр |
| курьерская_служба | home_improvement_store | ramen_restaurant | свадьба_место проведения |
| культурный_центр | общежитие | курорт_отель | оптовик |
| стоматологическая_клиника | отель | rest_stop |
Наряду с этими новыми типами API Places (новый) переместил следующие типы из таблицы 2 API Places в таблицу A API Places (новый). Это означает, что теперь вы можете использовать эти типы как часть поиска:
-
country -
administrative_area_level_1 -
administrative_area_level_2 -
postal_code -
locality
Динамические данные о месте
Places API (новый) поддерживает данные динамического ответа, такие как наличие зарядной станции для электромобилей или последние цены на топливо на заправочной станции. Используйте эти поля ответов для создания динамичного взаимодействия с пользователем.
Какой API вы выбираете?
Прежде чем вы сможете начать разработку приложения, вы должны выбрать свой API:
Если вы новый клиент и только начинаете работать с Places API, начните с новых API.
Если вы новый клиент и у существующего API, такого как автозаполнение мест или автозаполнение запросов, еще нет замены , вы можете использовать комбинацию новых и существующих API.
Если вы уже являетесь клиентом , вы можете продолжать использовать существующие API. Однако, чтобы воспользоваться преимуществами повышения производительности и расширенными возможностями Places API (нового), вы можете перейти на новые API.
Дополнительную информацию о миграции см. в разделе Обзор миграции .