Фотографии места

Выберите платформу: Android iOS Веб-служба JavaScript

Служба 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 and maxwidth properties accept an integer between 1 and 1600 .

    You must specify either maxheight , or maxwidth , or both.

Ссылки на фотографии

Все запросы к службе Place Photo должны включать в себя 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 .