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

Примечание. Серверные и клиентские библиотеки.

API Places также доступен с клиентом Java, клиентом Python, клиентом Go и клиентом Node.js для служб Google Maps . API Places и клиентские библиотеки предназначены для использования в серверных приложениях.

Хотите использовать этот сервис в приложении JavaScript? Взгляните на библиотеку Places, Maps JavaScript API .

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

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

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

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 (Legacy), взяты из разных мест, включая фотографии владельцев бизнеса и фотографии, предоставленные пользователями. В большинстве случаев эти фотографии можно использовать без указания авторства или они будут иметь необходимое указание авторства как часть изображения. Однако если возвращаемый элемент photo содержит значение в поле html_attributions , вы должны включить дополнительную атрибуцию в свое приложение, где бы вы ни отображали изображение.

Внимание: вы не можете кэшировать photo_reference . Кроме того, срок действия photo_reference может истечь. Убедитесь, что вы всегда получаете photo_reference из ответа на запрос сведений о месте (старая версия) , поиска места (старая версия) , поиска поблизости (старая версия) или текстового поиска (старая версия) . Дополнительную информацию см. в ограничениях кеширования, указанных в разделе 5.4 Особых условий использования платформы Google Maps.

В следующем примере показан запрос сведений о месте (устаревший вариант):

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

Примечание. Замените ключ API в этом примере собственным ключом API, чтобы запрос работал в вашем приложении.

Ответ «Разместить фотографии» (устаревшая версия)

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

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

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

• Отсылка к представленной фотографии указана неверно.
• Запрос не содержал параметров maxwidth и maxheight .
• Значение параметра maxwidth или maxheight было установлено равным null .
• Срок действия photo_reference истек. Если срок действия photo_reference истек, отправьте запрос к функциям Place Details (устаревшая версия) , Find Place (устаревшая версия) , «Поиск поблизости» (устаревшая версия) или «Текстовый поиск» (устаревшая версия), чтобы получить обновленное значение photo_reference .