Method: places.photos.getMedia

Получите фотофайл, содержащий строку с фотографическим идентификатором.

HTTP-запрос

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
name

string

Обязательно. Имя ресурса фотофайла в формате: places/{placeId}/photos/{photo_reference}/media .

Имя ресурса фотографии, возвращаемое полем photos.name объекта Place, имеет формат places/{placeId}/photos/{photo_reference} . Для получения имени ресурса медиафайлов фотографии необходимо добавить /media в конец имени ресурса фотографии.

Параметры запроса

Параметры
maxWidthPx

integer

Необязательный параметр. Задает максимальную желаемую ширину изображения в пикселях. Если изображение меньше указанных значений, будет возвращено исходное изображение. Если изображение больше по любому из измерений, оно будет масштабировано в соответствии с меньшим из двух измерений, с ограничением по исходному соотношению сторон. Свойства maxHeightPx и maxWidthPx принимают целое число от 1 до 4800 включительно. Если значение выходит за пределы допустимого диапазона, будет возвращена ошибка INVALID_ARGUMENT.

Необходимо указать хотя бы один из параметров maxHeightPx или maxWidthPx. Если не указаны ни maxHeightPx, ни maxWidthPx, будет возвращена ошибка INVALID_ARGUMENT.

maxHeightPx

integer

Необязательный параметр. Задает максимальную желаемую высоту изображения в пикселях. Если изображение меньше указанных значений, будет возвращено исходное изображение. Если изображение больше по любому из измерений, оно будет масштабировано в соответствии с меньшим из двух измерений, с ограничением по исходному соотношению сторон. Свойства maxHeightPx и maxWidthPx принимают целое число от 1 до 4800 включительно. Если значение выходит за пределы допустимого диапазона, будет возвращена ошибка INVALID_ARGUMENT.

Необходимо указать хотя бы один из параметров maxHeightPx или maxWidthPx. Если не указаны ни maxHeightPx, ни maxWidthPx, будет возвращена ошибка INVALID_ARGUMENT.

skipHttpRedirect

boolean

Необязательный параметр. Если задан, пропускается стандартное поведение перенаправления HTTP и отображается ответ в текстовом формате (например, в формате JSON для использования HTTP). Если параметр не задан, будет выполнено перенаправление HTTP для переадресации вызова к медиафайлу изображения. Этот параметр игнорируется для запросов, не использующих HTTP.

Текст запроса

Тело запроса должно быть пустым.

Ответный текст

Фотоматериалы предоставлены Places API.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "name": string,
  "photoUri": string
}
Поля
name

string

Имя ресурса фотофайла в формате: places/{placeId}/photos/{photo_reference}/media .

photoUri

string

Кратковременный URI, который можно использовать для отображения фотографии.

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

  • https://www.googleapis.com/auth/maps-platform.places.getphotomedia
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform