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

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

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

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

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

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

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

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

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

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

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

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

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