Введение
Places API (New) provides improved performance and a new pricing model, making it worthwhile to update apps that use the Places API (Legacy). For more details on comparing features, see Choose your 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-интерфейсом «Подробная информация о месте» (новый) .
- The JSON response format for the Place Details (New) , Nearby Search (New) , and Text Search (New) APIs has changed from the format of the existing APIs. For more details, see Migrate the Places API response .
изменения, специфичные для API
В этом разделе представлены следующие руководства по миграции для каждого API:
- Переключиться на поиск поблизости (новый)
- Переход на текстовый поиск (новая функция)
- Перенос данных о местоположении (новое)
- Перенести фотографии на сайт (новая функция)
- Переход на автозаполнение (новая функция)