Место фото (новое)

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

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

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

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

Попробуйте!

Размещать запросы на фото

Запрос Place Photo — это 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[] , если место имеет связанный фотографический контент.

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

  • name — строка, содержащая имя ресурса фотографии при выполнении запроса фотографии. Эта строка имеет вид:

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

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

В следующем примере показан запрос Place Details, который включает 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 Photo является изображение. Тип изображения зависит от типа изначально представленной фотографии.

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

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

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

Попробуйте!

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

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

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

  5. На панели API Explorer выберите значок развертывания, Разверните API Explorer. , чтобы развернуть окно API Explorer.