API Places (новый) обеспечивает улучшенную производительность и новую модель ценообразования, поэтому стоит обновлять приложения, использующие API Places. Дополнительные сведения о сравнении функций см. в разделе «Выберите свой API» .
Используйте это руководство, чтобы понять ключевые различия в Places API (новое) по сравнению с Places API, а также узнать, как обрабатывать необходимые изменения.
Рекомендации по выставлению счетов за миграцию
Это руководство применимо, если уровень использования API достаточно высок для перехода на цены второго уровня. При переходе на более новую версию API вам также будет выставлен счет за другой номер SKU. Чтобы избежать увеличения затрат в течение месяца перехода, мы рекомендуем перейти на новые API в рабочей версии как можно ближе к началу месяца. Это гарантирует, что вы достигнете наиболее экономичных ежемесячных ценовых уровней в течение месяца миграции. Информацию о ценовых уровнях см. на странице цен и в разделе часто задаваемых вопросов о ценах .
Включить API Адресов (новое)
Чтобы использовать функции Places API (New), необходимо сначала включить Places API (New) в своем проекте Google Cloud. Дополнительную информацию см. в разделе Настройка проекта Google Cloud .
Затем вам необходимо убедиться, что вы добавили Places API (новый) к ключу API, используемому вашим приложением. Дополнительные сведения см. в разделе Использование ключей API .
Общие изменения
Некоторые общие изменения, применимые к нескольким API, включают:
- Все новые API поддерживают как ключи API , так и токены OAuth в качестве механизма аутентификации.
- В качестве формата ответа поддерживается только JSON.
- Маскирование полей требуется для сведений о месте (новое), поиска поблизости (новое) и текстового поиска (новое), чтобы указать, какие поля вы хотите вернуть в ответе. Для получения дополнительной информации см. FieldMask .
- API-интерфейсы поиска поблизости (новое) и текстового поиска (новое) теперь возвращают полную информацию о месте, соответствующую сведениям о месте, возвращаемым функцией Place Details (новое) .
- Формат ответа JSON для API- интерфейсов «Сведения о месте» (новый) , «Поиск поблизости» (новый) и «Текстовый поиск (новый)» изменился по сравнению с форматом существующих API. Дополнительные сведения см. в разделе Миграция ответа Places API .
Изменения, специфичные для API
В этот раздел включены следующие руководства по миграции для каждого API: