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

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-адресах, все параметры разделяются символом амперсанда ( & ). Список параметров и их возможных значений приведен ниже.

Необходимые параметры

• фото_ссылка

  Строковый идентификатор, однозначно идентифицирующий фотографию. Ссылки на фотографии возвращаются либо из запроса поиска места, либо из запроса сведений о месте.

• максимальная высота или максимальная ширина

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

  maxwidth задает максимальную предпочтительную ширину изображения в пикселях. Если изображение меньше указанных значений, будет возвращено исходное изображение. Если изображение больше по любому из этих параметров, оно будет масштабировано в соответствии с меньшим из двух параметров, с сохранением исходного соотношения сторон.

  Свойства maxheight и maxwidth принимают целое число от 1 до 1600 .

  Необходимо указать либо maxheight ), либо maxwidth ), либо оба параметра.

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

Все запросы к 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 .