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 필드에 반환되는 사진의 리소스 이름은 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 리디렉션 동작을 건너뛰고 텍스트 형식 (예: HTTP 사용 사례의 경우 JSON 형식) 응답을 렌더링합니다. 설정하지 않으면 HTTP 리디렉션이 실행되어 호출을 이미지 미디어로 리디렉션합니다. HTTP가 아닌 요청의 경우 이 옵션은 무시됩니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

Places API의 사진 미디어입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "name": string,
  "photoUri": string
}
필드
name

string

사진 미디어의 리소스 이름으로, places/{placeId}/photos/{photo_reference}/media 형식입니다.
photoUri

string

사진을 렌더링하는 데 사용할 수 있는 단기 URI입니다.