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

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

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

Запросы к устаревшему сервису Place Photos

Запрос к устаревшему API "Фотографии мест" представляет собой 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 (устаревшая версия), поиск поблизости (устаревшая версия), текстовый поиск (устаревшая версия) или информация о местах (устаревшая версия). Если у места есть фотографии, в ответе на запрос будет поле photos[].

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

  • В ответах на запросы Find Place (Legacy), поиск поблизости (Legacy) и текстовый поиск (Legacy) возвращается не более одного элемента photo в массиве.
  • В ответах на запрос информации о местах (устаревшая версия) возвращается до десяти элементов photo.

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

  • photo_reference – строка, используемая для идентификации фотографии при выполнении запроса Place Photos (Legacy).
  • 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"
       }]
    ...

Пример использования устаревшего сервиса Place Photos

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

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

Ответ на запрос Place Photos (устаревшая версия)

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

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

Изображение "Квота превышена"

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