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

Тип
американский_ресторан скидка_магазин 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:

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

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

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

Тип
американский_ресторан скидка_магазин 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 рамэн_ресторан свадьба_место проведения
культурный_центр общежитие курорт_отель оптовик
стоматологическая_клиника отель 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:

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

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

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

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