Выберите свою версию API

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 добавляет типы мест, показанные в таблице ниже. Вы можете использовать эти новые и существующие типы при поиске с помощью поиска по соседству (новое) и текстового поиска (новое). Все новые типы включены в Таблицу А.

Тип
американский_ресторан скидка_магазин магазин мороженого сэндвич_магазин
центр развлечений собака_парк индийский_ресторан школьный округ
спортивная площадка electric_vehicle_charging_station индонезийский_ресторан ресторан морепродуктов
auto_parts_store событие_место проведения Итальянский ресторан лыжный курорт
банкетный зал Extended_stay_hotel Японский ресторан испанский_ресторан
барбекю_ресторан ферма корейский_ресторан магазин спортивных товаров
парикмахерская проживание на ферме lebanese_restaurant спортивный клуб
кровать и завтрак Ресторан быстрого питания Марина спортивный комплекс
бразильский_ресторан паромный терминал рынок стейк-хаус
завтрак_ресторан фитнес-центр медицинская_лаборатория суши_ресторан
бранч_ресторан французский ресторан средиземноморский_ресторан бассейн
автобусная остановка магазин подарков мексиканский ресторан портной
кемпинг_кабина поле для гольфа middle_eastern_restaurant поставщик_телекоммуникационных_услуг
cell_phone_store греческий_ресторан мотель тайский_ресторан
child_care_agency продуктовый магазин Национальный парк транзит_депо
Китайский ресторан гостевой дом park_and_ride грузовик_стоп
кофейный магазин парикмахерская театр_исполнительского_искусства турецкий_ресторан
общественный центр гамбургер_ресторан пицца_ресторан веганский_ресторан
консультант вертолетная площадка детская площадка вегетарианский_ресторан
конференц-центр зона походов дошкольный вьетнамский_ресторан
коттедж исторический_ориентир Private_guest_room посетитель_центр
курьерская служба home_improvement_store ramen_restaurant место свадьбы
Центр культуры общежитие курортный отель оптовик
Стоматологическая клиника Гостиница привал

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

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

Динамические данные о месте

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

Какой API вы выбираете?

Прежде чем вы сможете начать разработку приложения, вы должны выбрать свой API:

  1. Если вы новый клиент и только начинаете работать с Places API, начните с новых API.

  2. Если вы новый клиент и у существующего API, такого как автозаполнение мест или автозаполнение запросов, еще нет замены, вы можете использовать комбинацию новых и существующих API.

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

    Дополнительную информацию о миграции см. в разделе Обзор миграции .