Фотографии мест (устаревшие версии),Фотографии мест (устаревшие версии),Фотографии мест (устаревшие версии),Фотографии мест (устаревшие версии)

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

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

Запросы на размещение фотографий (устаревшие)

Запрос Place Photos (Legacy) представляет собой HTTP-URL-адрес следующего вида:

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.

Фотоссылки

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

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

  • Запросы «Найти место» (устаревшая версия), «Поиск поблизости» (устаревшая версия) или «Поиск текста» (устаревшая версия) возвращают не более одного элемента photo в массиве.
  • Запрос «Сведения о месте (устаревшая версия)» возвращает до десяти элементов photo .

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

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

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

В следующем примере показан запрос Place Details (Legacy):

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 Photos (Legacy) является изображение. Тип изображения зависит от типа изначально отправленной фотографии.

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

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

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