Служба Place Photo, входящая в состав Places API, представляет собой API, доступный только для чтения, который позволяет добавлять в приложение высококачественный фотографический контент. Сервис Place Photo предоставляет вам доступ к миллионам фотографий, хранящихся в базе данных Places. Когда вы получаете информацию о месте с помощью запроса Place Details, ссылки на фотографии будут возвращены для соответствующего фотографического контента. Запросы «Найти место», «Поиск поблизости» и «Текстовый поиск» также возвращают одну ссылку на фотографию для каждого места, если это необходимо. Используя службу фотографий, вы можете получить доступ к указанным фотографиям и изменить размер изображения до оптимального размера для вашего приложения.
Размещать запросы на фото
Запрос Place Photo – это URL-адрес HTTP следующей формы:
https://maps.googleapis.com/maps/api/place/photo?parameters
Для инициирования поискового запроса необходимы определенные параметры. Как это принято в URL-адресах, все параметры разделяются символом амперсанда ( &
). Список параметров и их возможные значения перечислены ниже.
Required parameters
photo_reference
A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.
maxheight or maxwidth
maxheight
specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.maxwidth
specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.You must specify either
maxheight
, ormaxwidth
, or both.
Ссылки на фотографии
Все запросы к службе фотографий мест должны включать в себя параметр photo_reference
, возвращаемый в ответ на запрос «Найти место», «Поиск поблизости», «Текстовый поиск» или «Подробности о месте». Ответ на эти запросы будет содержать поле photos[]
, если место имеет соответствующий фотографический контент.
Примечание. Количество возвращаемых фотографий зависит от запроса.
- Запрос «Найти место», «Поиск поблизости» или «Поиск текста» возвращает не более одного элемента
photo
в массиве. - Запрос сведений о месте возвращает до десяти элементов
photo
.
Каждый элемент photo
содержит следующие поля:
-
photo_reference
— строка, используемая для идентификации фотографии при выполнении запроса фотографии. -
height
— максимальная высота изображения. -
width
— максимальная ширина изображения. -
html_attributions[]
— содержит все необходимые атрибуты. Это поле всегда будет присутствовать, но может быть пустым.
Фотографии, возвращаемые службой фотографий, берутся из разных мест, включая фотографии владельцев бизнеса и фотографии, предоставленные пользователями. В большинстве случаев эти фотографии можно использовать без указания авторства или же оно будет включено в изображение как часть изображения. Однако если возвращаемый элемент photo
содержит значение в поле html_attributions
, вы должны включить дополнительную атрибуцию в свое приложение, где бы вы ни отображали изображение.
В следующем примере показан запрос сведений о месте:
curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"
Пример массива photos[]
в ответе показан ниже.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
}
...
Пример фотографии места
Пример запроса показан ниже. Этот запрос вернет указанное изображение, изменив его размер так, чтобы его ширина составляла не более 400 пикселей.
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q &key=YOUR_API_KEY
Разместить фотоответ
Ответом на успешный запрос Place Photo будет изображение. Тип изображения будет зависеть от типа первоначально отправленной фотографии.
Если ваш запрос превышает доступную квоту, сервер вернет статус HTTP 403 и отобразит изображение ниже, указывающее, что квота превышена:
Если сервер не может понять ваш запрос, он возвращает статус HTTP 400, что указывает на недействительный запрос. К наиболее частым причинам недействительного запроса относятся:
- Отсылка к представленной фотографии указана неверно.
- Запрос не содержал параметров
maxwidth
иmaxheight
. - Значение параметра
maxwidth
илиmaxheight
было установлено равнымnull
. - Срок действия
photo_reference
истек. Если срок действияphoto_reference
истек, отправьте запрос на Place Details , Find Place , Nearby Search или Text Search , чтобы получить обновленное значениеphoto_reference
.