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 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/cloud-platform