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

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

Введение

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

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

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

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

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

В старой версии приложения «Фотографии» максимальный размер фотографий составлял 1600 на 1600 пикселей. В новой версии «Фотографии» поддерживаются размеры до 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 — Строка, используемая для идентификации фотографии при выполнении запроса на получение фотографии.
  • height — максимальная высота изображения.
  • width — максимальная ширина изображения.
  • html_attributions[] — Все необходимые указания авторства. Это поле всегда присутствует, но может быть пустым.