Обзор миграции

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

Введение

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

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

Лучшие практики выставления счетов для миграции

Это руководство применимо, если использование API достаточно интенсивно для перехода на тариф второго уровня. При переходе на новую версию API с вас также будет взиматься плата за другой артикул. Чтобы избежать увеличения расходов в течение месяца перехода, мы рекомендуем переходить на новые API в рабочей среде как можно ближе к началу месяца. Это позволит вам достичь наиболее экономически эффективных тарифных планов в течение месяца миграции. Подробнее о тарифных планах см. на странице тарифов и в разделе часто задаваемых вопросов о ценах .

Включить API Places (новое)

Чтобы использовать функции Places API (новый), необходимо сначала включить Places API (новый) в вашем проекте Google Cloud. Подробнее см. в статье «Настройка проекта Google Cloud» .

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

Общие изменения

Некоторые общие изменения, которые применяются к нескольким API, включают:

  • Все новые API поддерживают как ключи API , так и токены OAuth в качестве механизма аутентификации.
  • В качестве формата ответа поддерживается только JSON.
  • Маскирование полей требуется для функций «Сведения о месте (новое)», «Поиск поблизости (новое)» и «Текстовый поиск (новое)», чтобы указать, какие поля должны быть возвращены в ответе. Подробнее см. в разделе FieldMask .
  • API-интерфейсы Nearby Search (новый) и Text Search (новый) теперь возвращают полную информацию о месте, которая соответствует информации о месте, возвращаемой Place Details (новый) .
  • Формат ответа JSON для API Place Details (новый) , Nearby Search (новый) и Text Search (новый) изменился по сравнению с форматом существующих API. Подробнее см. в разделе Миграция ответа API Places .

Изменения, специфичные для API

В этот раздел включены следующие руководства по миграции для каждого API: