Введение
Новый API для работы с Places обеспечивает улучшенную производительность и новую модель ценообразования, что делает целесообразным обновление приложений, использующих устаревший API для работы с Places. Более подробную информацию о сравнении функций см. в разделе «Выбор API» .
Воспользуйтесь этим руководством, чтобы понять ключевые различия между Places API (новая версия) и Places API (старая версия), а также как вносить необходимые изменения.
Рекомендации по выставлению счетов при миграции
Данное руководство применимо, если использование вашего API достаточно велико для перехода на тарифный план второго уровня. При миграции на более новую версию API с вас также будет взиматься плата за другой SKU. Чтобы избежать увеличения затрат в течение месяца перехода, мы рекомендуем переключиться на новые API, находящиеся в эксплуатации, как можно ближе к началу месяца. Это обеспечит вам доступ к наиболее выгодным ежемесячным тарифным планам в течение месяца миграции. Информацию о тарифных планах см. на странице с ценами и в разделе часто задаваемых вопросов о ценах .
Включить 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:
- Переключиться на поиск поблизости (новый)
- Переход на текстовый поиск (новая функция)
- Перенос данных о местоположении (новое)
- Перенести фотографии на сайт (новая функция)
- Переход на автозаполнение (новая функция)