Введение
Новый API для работы с Places обеспечивает улучшенную производительность и новую модель ценообразования, что делает целесообразным обновление приложений, использующих устаревший API для работы с Places. Более подробную информацию о сравнении функций см. в разделе «Выбор API» .
Воспользуйтесь этим руководством, чтобы понять ключевые различия между Places API (новая версия) и Places API (старая версия), а также как вносить необходимые изменения.
Рекомендации по выставлению счетов при миграции
This guidance applies if your API usage is high enough to move into second-tier pricing. When migrating to a newer version of an API, you're also being billed for a different SKU. To avoid increased costs during the month of your transition, we recommend switching to the new APIs in production as close to the beginning of the month as possible. This will ensure that you reach the most cost-effective monthly pricing tiers during the migration month. For information about pricing tiers, see the pricing page and the pricing FAQ .
Включить API для мест (новая функция)
Чтобы использовать новые функции Places API, необходимо сначала включить Places API (New) в вашем проекте Google Cloud. Дополнительную информацию см. в разделе «Настройка проекта Google Cloud» .
Затем необходимо убедиться, что вы добавили Places API (новый) к ключу API, используемому вашим приложением. Для получения дополнительной информации см. раздел «Использование ключей API» .
Общие изменения
К числу общих изменений, применимых к нескольким API, относятся следующие:
- Все новые API поддерживают как ключи API , так и токены OAuth в качестве механизма аутентификации.
- В качестве формата ответа поддерживается только JSON.
- Маскирование полей необходимо для функций «Подробная информация о месте» (новая функция), «Поиск поблизости» (новая функция) и «Текстовый поиск» (новая функция), чтобы указать, какие поля вы хотите получить в ответе. Для получения дополнительной информации см. FieldMask .
- API-интерфейсы «Поиск поблизости» (новый) и «Текстовый поиск» (новый) теперь возвращают полные сведения о месте, соответствующие сведениям о месте, возвращаемым API-интерфейсом «Подробная информация о месте» (новый) .
- Формат JSON-ответа для API « Подробная информация о местах» (новый формат) , «Поиск поблизости» (новый формат) и «Текстовый поиск» (новый формат) изменился по сравнению с форматом существующих API. Для получения более подробной информации см. раздел «Перенос ответа API мест» .
изменения, специфичные для API
В этом разделе представлены следующие руководства по миграции для каждого API:
- Переключиться на поиск поблизости (новый)
- Переход на текстовый поиск (новая функция)
- Перенос данных о местоположении (новое)
- Перенести фотографии на сайт (новая функция)
- Переход на автозаполнение (новая функция)