Переход на функцию "Фотографии места" (новая версия)

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

Введение

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

  • В новой версии Place Photos в URL запроса нужно передавать название ресурса фотографии, которое включает идентификатор места, а не только ссылку на фотографию. Подробнее об изменениях в ссылках на фотографии…
  • Place Photos (New) поддерживает в качестве механизма аутентификации как ключи API, так и токены OAuth.

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

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

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

Place Photos (Legacy) поддерживает максимальный размер фото 1600 x 1600 пикселей. Place Photos (New) поддерживает размеры до 4800 x 4800 пикселей.

Изменить референсы по фото

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

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

Устаревшие версии Find Place, Nearby Search, текстового поиска и информации о местах возвращают в ответе массив photos[], поддерживающий этот формат. Каждый элемент photo в устаревшем ответе содержит следующие поля:

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