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

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

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

Запросы на размещение фотографий (наследие)

Запрос 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.

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

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

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

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

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

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

Пример фотографий мест (наследие)

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

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

Ответ Place Photos (наследие)

В ответ на успешный запрос на предоставление фотографий мест (наследие) вы получите изображение. Тип изображения зависит от типа первоначально предоставленной фотографии.

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

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

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

  • В предоставленном документе не была указана корректная ссылка на фотографию.
  • В запросе отсутствовали параметры maxwidth и maxheight .
  • Значение параметра maxwidth или maxheight было установлено равным null .
  • Срок действия photo_reference истек. Если photo_reference истек, отправьте запрос в Place Details (Legacy) , Find Place (Legacy) , Nearby Search (Legacy) или Text Search (Legacy) , чтобы получить обновленное значение photo_reference .