Место Фото

Выберите платформу: Android iOS JavaScript Web Service

Служба Place Photo, входящая в состав Places API, представляет собой API только для чтения, который позволяет добавлять в приложение высококачественные фотографии. Сервис Place Photo предоставляет доступ к миллионам фотографий, хранящихся в базе данных Places. Когда вы получаете информацию о месте с помощью запроса сведений о месте, ссылки на фотографии будут возвращены для соответствующего фотографического контента. Запросы «Найти место», «Поиск поблизости» и «Поиск по тексту» также возвращают одну ссылку на фотографию для каждого места, если это необходимо. Используя сервис 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.

Optional parameters

  • 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. Both the maxheight and maxwidth properties accept an integer between 1 and 1600 .

  • 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 .

Generated from the OpenAPI specification . Edit Report bug

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

Все запросы к сервису фотографий мест должны включать photoreference , возвращенную в ответ на запрос «Поиск места», «Поиск поблизости», «Поиск текста» или «Сведения о месте». Ответ на эти запросы будет содержать поле photos[] если место содержит связанный с ним фотоконтент.

Примечание. Количество возвращаемых фотографий зависит от запроса.

  • Запрос «Найти место», «Поиск поблизости» или «Поиск текста» возвращает не более одного photo в массиве.
  • Запрос сведений о месте возвращает до десяти photo .

Каждый элемент photo будет содержать следующие поля:

  • photo_reference — строка, используемая для идентификации фотографии при выполнении запроса на фотографию.
  • height — максимальная высота изображения.
  • width — максимальная ширина изображения.
  • html_attributions[] — содержит все необходимые атрибуты. Это поле всегда будет присутствовать, но может быть пустым.

Фотографии, возвращаемые службой фотографий, получены из разных источников, включая фотографии, предоставленные владельцами компаний, и фотографии, предоставленные пользователями. В большинстве случаев эти фотографии могут быть использованы без указания авторства или будут содержать требуемое указание авторства как часть изображения. Однако, если возвращаемый элемент photo включает значение в поле html_attributions , вы должны включить дополнительную атрибуцию в свое приложение, где бы вы ни отображали изображение.

Пример массива photos[] показан ниже.

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

Пример фото места

Пример запроса показан ниже. Этот запрос вернет указанное изображение, изменив его размер так, чтобы его ширина была не более 400 пикселей.

https://maps.googleapis.com/maps/api/place/photo
  ?maxwidth=400
  &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT
  &key=YOUR_API_KEY

Разместить фотоответ

Ответом на успешный запрос Place Photo будет изображение. Тип изображения будет зависеть от типа исходной фотографии.

Если ваш запрос превышает доступную квоту, сервер вернет статус HTTP 403 и отобразит изображение ниже, чтобы указать, что квота превышена:

Изображение превышения квоты

Если сервер не может понять ваш запрос, он возвращает статус HTTP 400, что указывает на недопустимый запрос. Наиболее распространенные причины недействительного запроса включают в себя:

  • Представленная ссылка на фото была указана неправильно.
  • Запрос не включал параметры maxwidth или maxheight .
  • Значение параметра maxwidth или maxheight было установлено равным null .