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