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

Проект: /maps/documentation/places/web-service/_project.yaml Книга: /maps/documentation/places/web-service/_book.yaml

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

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

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