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

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

Разработчики из Европейской экономической зоны (ЕЭЗ)

Если ваш платежный адрес находится в Европейской экономической зоне, то с 8 июля 2025 года к использованию вами Услуг будут применяться Условия предоставления услуг платформы Google Maps для стран ЕЭЗ . Функциональность различается в зависимости от региона. Подробнее .

Важно: использование данных, возвращаемых этим конечным пунктом, регулируется применимыми правилами и авторскими правами Places API .

Введение

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

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

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

Попробуйте!

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

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

Запрос Place Photos (новый) — это HTTP GET-запрос к URL-адресу в следующем формате:

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

В случаях, когда требуются следующие параметры:

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

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

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

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

Строковый идентификатор, однозначно идентифицирующий фотографию. Названия фотографий возвращаются из запросов «Подробности о месте» (Новое) , «Поиск поблизости» (Новое) или «Текстовый поиск» (Новое) в свойстве name каждого элемента массива photos[] .

В качестве примера см. раздел «Получение названия фотографии» .

maxHeightPx и maxWidthPx

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

Необходимо указать либо maxHeightPx , либо maxWidthPx , либо оба параметра.

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

skipHttpRedirect

Если 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.

Придумайте название для фотографии

Все запросы к Place Photos (новые) должны содержать имя фоторесурса, возвращаемое в ответе на запрос Nearby Search (новые), Text Search (новые) или Place Details (новые). Ответ на эти запросы содержит массив photos[] если для места имеется связанный фотоконтент.

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

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

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

  places/PLACE_ID/photos/PHOTO_RESOURCE

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

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

Внимание: вы не можете кэшировать название фотографии. Кроме того, срок действия названия может истечь. Убедитесь, что вы всегда получаете название из ответа на запрос к функциям «Подробности места» (новая функция) , «Поиск поблизости» (новая функция) или «Текстовый поиск» (новая функция) . Для получения дополнительной информации см. ограничения кэширования в разделе 3.2.3(b) (Запрет на кэширование) Условий использования платформы Google Maps .

В следующем примере показан запрос на получение сведений о месте (новый), который включает 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/ATKogpeivkIjQ1FT7QmbeT33nBSwqLhdPvIWHfrG1WfmgrFjeZYpS_Ls7c7rj8jejN9QGzlx4GoAH0atSvUzATDrgrZic_tTEJdeITdWL-oG3TWi5HqZoLozrjTaxoAIxmROHfV5KXVcLeTdCC6kmZExSy0CLVIG3lAPIgmvUiewNf-ZHYE4-jXYwPQpWHJgqVosvZJ6KWEgowEA-qRAzNTu9VH6BPFqHakGQ7EqBAeYOiU8Dh-xIQC8FcBJiTi0xB4tr-MYXUaF0p_AqzAhJcDE6FAgLqG1s7EsME0o36w2nDRHA-IuoISBC3SIahINE3Xwq2FzEZE6TpNTFVfgTpdPhV8CGLeqrauHn2I6ePm-2hA8-87aO7aClXKJJVzlQ1dc_JuHz6Ks07d2gglw-ZQ3ibCTF5lMtCF9O-9JHyRQXsfuXw/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY

В ответ на успешный запрос «Фотографии мест (новые)» вы получите изображение.

Примечание: формат изображения может отличаться. Поддерживаются стандартные форматы изображений (включая JPEG, PNG и GIF), но Google не гарантирует формат изображения.

коды ошибок

Запросы на размещение фотографий (новые) могут возвращать следующие коды ошибок.

Квота превышена (403)

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

Неверный запрос (404)

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

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

Слишком много запросов (429)

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

Попробуйте!

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

Чтобы отправить запрос:

1. Выберите API в правой части страницы.
2. Установите параметр name следующим образом:

   places/PLACE_ID/photos/PHOTO_RESOURCE/media

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

5. На панели «Обозреватель API» выберите значок « режим», чтобы развернуть окно «Обозреватель API».