API Places поддерживает существующую фотографию места . Если вы знакомы с существующей фотографией места, новая версия фотографии места вносит следующие изменения:
- Новая служба фотографий мест требует, чтобы вы передали имя ресурса фотографии, которое включает идентификатор места в URL-адрес запроса, а не только ссылку на фотографию. Дополнительную информацию см. в разделе Изменение ссылок на фотографии .
- Новый сервис Place Photo поддерживает как ключи API , так и токены OAuth в качестве механизма аутентификации.
В следующей таблице перечислены параметры существующей фотографии места, которые были переименованы или изменены для новой фотографии места, а также параметры, которые больше не поддерживаются.
Текущий параметр | Новый параметр | Примечания |
---|---|---|
maxheight | maxHeightPx | Вы должны указать maxHeightPx , maxWidthPx или оба. |
maxwidth | maxWidthPx | Вы должны указать maxHeightPx , maxWidthPx или оба. |
Увеличен размер фотографии
Существующая фотография места поддерживала максимальный размер фотографии 1600 на 1600 пикселей. Place Photo (новое) поддерживает размеры до 4800 на 4800 пикселей.
Перейти к ссылкам на фотографии
Новый 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
Существующие функции «Найти место», «Поиск поблизости», «Текстовый поиск» и «Сведения о месте» возвращают в ответ массив photos[]
, который поддерживает этот формат. Каждый элемент photo
в существующем ответе содержит следующие поля:
-
photo_reference
— строка, используемая для идентификации фотографии при выполнении запроса фотографии. -
height
— максимальная высота изображения. -
width
— максимальная ширина изображения. -
html_attributions[]
— Любые необходимые атрибуты. Это поле всегда присутствует, но может быть пустым.