Эта страница переведена с помощью Cloud Translation API.

Фотографии мест (новинка)

Выберите платформу: Веб-сервис Android iOS.

Служба Place Photos (новая) — это API, доступный только для чтения, который позволяет добавлять в приложение высококачественный фотографический контент. Place Photos (новинка) дает вам доступ к миллионам фотографий, хранящихся в базе данных Places.

Когда вы получаете информацию о месте с помощью запроса «Сведения о месте» (новое), «Поиск поблизости» (новое) или «Текстовый поиск (новое)», вы также можете запросить фоторесурсы для соответствующего фотографического контента. Используя «Разместить фотографии (новое)», вы можете получить доступ к указанным фотографиям и изменить размер изображения до оптимального размера для вашего приложения.

Обозреватель API позволяет вам делать запросы в реальном времени, чтобы вы могли ознакомиться с API и опциями API:

Попробуйте!

Примечание. Введите name места из массива photos в тексте ответа «Сведения о месте (новое)» и нажмите «Выполнить». Чтобы просмотреть фотографию, используйте значение photoUri в тексте ответа «Разместить фотографии (новое)».

Разместить запросы на фотографии (новые)

Запрос Place Photos (New) — это HTTP-запрос GET к URL-адресу в форме:

https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS

Где необходимы следующие параметры:

NAME содержит имя ресурса фотографии.
API_KEY содержит ключ API.
PARAMETERS содержит параметр maxHeightPx , параметр maxWidthPx или оба параметра.

Полный список обязательных и дополнительных параметров описан ниже.

Обязательные параметры

Название фотографии

Строковый идентификатор, однозначно идентифицирующий фотографию. Названия фотографий возвращаются из запроса Place Details (New) , Nearby Search (New) или Text Search (New) в свойстве name каждого элемента массива photos[] .

Пример см. в разделе Получение имени фотографии .

maxHeightPx и maxWidthPx

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

Вы должны указать либо maxHeightPx , либо maxWidthPx , либо оба.

Дополнительные параметры

пропуститьHttpRedirect

Если false (по умолчанию), выполните перенаправление HTTP на изображение, чтобы вернуть изображение. Если true , пропустите перенаправление и верните ответ JSON, содержащий сведения об изображении. Например:

{
  "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media",
  "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo"
}

Эта опция игнорируется для запросов, отличных от HTTP.

Получить название фотографии

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

Примечание. Чтобы включить массив photos[] в ответ, обязательно включите photos (сведения о месте (новое)) или places.photos (поиск поблизости (новое) и текстовый поиск (новое)) в маску поля запроса. Каждый API может возвращать до 10 фотографий для определенного местоположения.

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

name — строка, содержащая имя ресурса фотографии при выполнении запроса фотографии. Эта строка имеет вид:
```
places/PLACE_ID/photos/PHOTO_RESOURCE
```
heightPx — Максимальная высота изображения в пикселях.
widthPx — Максимальная ширина изображения в пикселях.
authorAttributions[] — Любые необходимые сведения об авторстве. Это поле всегда присутствует, но может быть пустым.

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

В следующем примере показан запрос сведений о месте (новый), который включает photos в маску поля, поэтому ответ включает в себя массив photos[] :

curl -X GET \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,photos" \
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E

Ниже показан пример массива photos[] в ответе.

    ...
    "photos" : [
      {
        "name": "places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1",
        "widthPx": 6000,
        "heightPx": 4000,
        "authorAttributions": [
          {
            "displayName": "John Smith",
            "uri": "//maps.google.com/maps/contrib/101563",
            "photoUri": "//lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo"
          }
        ]
      },    ...

Запросить фото места

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

https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY

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

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

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

Название отправленной фотографии указано неверно.
Запрос не включал параметр maxHeightPx или maxWidthPx .
Значение параметра maxHeightPx или maxWidthtPx было установлено в null .
Срок действия name истек. Если срок действия name истек, отправьте запрос на «Сведения о месте» (новое) , «Поиск поблизости» (новое) или «Текстовый поиск (новое)», чтобы получить новое name .

Попробуйте!

API Explorer позволяет вам создавать примеры запросов, чтобы вы могли ознакомиться с API и опциями API.

Чтобы сделать запрос:

Выберите значок API API в правой части страницы.
Установите для параметра name значение:
```
places/PLACE_ID/photos/PHOTO_RESOURCE/media
```
Примечание. Убедитесь, что вы используете name из недавнего запроса сведений о месте (новое), поскольку срок действия name может истечь.
Установите для skipHttpRedirect значение true , чтобы запрос возвращал ответ в формате JSON. По умолчанию запрос возвращает изображение, которое не может отобразиться API Explorer.
Нажмите кнопку «Выполнить» . В диалоговом окне выберите учетную запись, которую вы хотите использовать для отправки запроса.
На панели API Explorer выберите полноэкранный значок полноэкранного режима, чтобы развернуть окно API Explorer.