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