Миграция для размещения фотографий (новинка)

Разработчики Европейской экономической зоны (ЕЭЗ)

Введение

API Places поддерживает Place Photos (устаревшую версию) . Если вы знакомы с Place Photos (устаревшую версию), Place Photos (новая версия) вносит следующие изменения:

  • Для функции «Фотографии места (новое)» необходимо передать имя ресурса фотографии, включая идентификатор места в URL-адресе запроса, а не только ссылку на фотографию. Подробнее см. в разделе «Изменение ссылок на фотографии» .
  • Place Photos (новое) поддерживает как ключи API , так и токены OAuth в качестве механизма аутентификации.

В следующей таблице перечислены параметры в Place Photos (Legacy), которые были переименованы или изменены для Place Photos (New), а также параметры, которые больше не поддерживаются.

Текущий параметр Новый параметр Примечания
maxheight maxHeightPx Необходимо указать maxHeightPx , maxWidthPx или оба.
maxwidth maxWidthPx Необходимо указать maxHeightPx , maxWidthPx или оба.

Увеличенный размер фото

Place Photos (устаревшая версия) поддерживала максимальный размер фотографий 1600 на 1600 пикселей. Place Photos (новая версия) поддерживает размеры до 4800 на 4800 пикселей.

Изменить на фотоссылки

API Place Photos (новое) требует, чтобы вы передали имя ресурса запрашиваемой фотографии, которое включает идентификатор места и ссылку на фотографию , в форме:

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

Поиск поблизости (новый), текстовый поиск (новый) и информация о месте (новый) возвращают массив photos[] в ответе, поддерживающем этот формат. Каждый элемент photos[] в новом ответе содержит следующие поля:

  • name — строка, содержащая имя ресурса фотографии. Эта строка имеет следующий вид:

    places/PLACE_ID/photos/PHOTO_REFERENCE
  • heightPx — максимальная высота изображения в пикселях.
  • widthPx — максимальная ширина изображения в пикселях.
  • authorAttributions[] — любые обязательные указания авторства. Это поле всегда присутствует, но может быть пустым.

При использовании устаревшего API вам достаточно передать только ссылку на фотографию в форме:

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

Функции «Найти место» (устаревшая версия), «Поиск поблизости» (устаревшая версия), «Текстовый поиск» (устаревшая версия) и «Сведения о месте» (устаревшая версия) возвращают массив photos[] в ответе, поддерживающем этот формат. Каждый элемент photo в ответе содержит следующие поля:

  • photo_reference — строка, используемая для идентификации фотографии при выполнении запроса Photo.
  • height — максимальная высота изображения.
  • width — максимальная ширина изображения.
  • html_attributions[] — любые обязательные указания авторства. Это поле всегда присутствует, но может быть пустым.