Фотографии мест (устаревшая функция)

Разработчики из Европейской экономической зоны (ЕЭЗ)

Place Photos (Legacy) – это часть Places API, предназначенная только для чтения. С помощью этого API вы можете добавлять в свое приложение высококачественные фотографии. Place Photos (Legacy) открывает доступ к миллионам фотографий, которые хранятся в базе данных Places. Идентификаторы фотографий возвращаются автоматически при запросе данных о конкретном месте. В ответ на запросы Find Place (устаревший), Nearby Search (устаревший) и Text Search (устаревший) для каждого места также возвращается один идентификатор фотографии (при наличии). Используя фотографии мест (устаревшая версия), вы можете получить доступ к указанным фотографиям и изменить размер изображения до оптимального для вашего приложения.

Запросы Place Photos (Legacy)

Запрос Place Photos (Legacy) – это URL с протоколом HTTP следующего вида:

https://maps.googleapis.com/maps/api/place/photo?parameters

Для инициации запроса поиска места необходимо задать определенные параметры. Параметры разделяются амперсандами (&) в соответствии со стандартом написания URL. Ниже приведен список параметров и их возможных значений.

Обязательные параметры

photo_reference

Строковый идентификатор, который уникальным образом идентифицирует фотографию. Идентификаторы фотографий возвращаются в ответ на запросы поиска мест или информации о местах.

maxheight или maxwidth;

maxheight – максимальная высота изображения в пикселях. Если изображение меньше указанных значений, будет возвращено исходное изображение. Если изображение больше по какому-либо из параметров, оно будет масштабировано в соответствии с меньшим из двух параметров с сохранением исходного соотношения сторон.

maxwidth – максимальная ширина изображения в пикселях. Если изображение меньше указанных значений, будет возвращено исходное изображение. Если изображение больше по какому-либо из параметров, оно будет масштабировано в соответствии с меньшим из двух параметров с сохранением исходного соотношения сторон.

Оба свойства, maxheight и maxwidth, принимают целое число от 1 до 1600.

Необходимо указать maxheight, maxwidth или оба значения.

Референсные фото

Все запросы к Place Photos (устаревшая версия) должны включать параметр photo_reference, возвращаемый в ответе на запрос Find Place (устаревшая версия), Nearby Search (устаревшая версия), текстовый поиск (устаревшая версия) или информация о местах (устаревшая версия). Если у места есть фотографии, в ответе на запрос будет поле photos[].

  • Запрос Find Place (Legacy), Nearby Search (Legacy) или Text Search (Legacy) возвращает в массиве не более одного элемента photo.
  • Запрос информации о местах (Legacy) возвращает до десяти элементов photo.

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

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

Place Photos (Legacy) передает изображения из множества источников, в том числе фотографии, предоставленные владельцами компаний и пользователями. Как правило, такие фотографии можно использовать без упоминания авторства, или оно будет указано непосредственно на снимке. Однако, если возвращенный элемент 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"
       }]
    ...

Пример использования Place Photos (Legacy)

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

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

Ответ Place Photos (Legacy)

Ответом на успешный запрос Place Photos (Legacy) является изображение. Тип изображения зависит от типа исходной фотографии.

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

Изображение: хранилище заполнено

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