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

Place Photos (Legacy), часть API Places, представляет собой 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[] , если место имеет связанный фотографический контент.

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

  • Запросы Find Place (устаревшая версия), Nearby Search (устаревшая версия) или Text Search (устаревшая версия) возвращают не более одного элемента photo в массиве.
  • Запрос «Сведения о месте (устаревшая версия)» возвращает до десяти элементов 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"
       }]
    ...

Пример размещения фотографий (устаревших)

Пример запроса показан ниже. Этот запрос возвращает указанное изображение, изменяя его размер так, чтобы оно было не более 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, что указывает на недействительный запрос. Наиболее распространенные причины недействительного запроса включают в себя:

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