사진 참조 문자열로 사진 미디어를 가져옵니다.
HTTP 요청
GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
name |
필수 항목입니다. 사진 미디어의 리소스 이름으로 장소 객체의 |
쿼리 매개변수
매개변수 | |
---|---|
maxWidthPx |
선택사항입니다. 원하는 이미지의 최대 너비를 픽셀 단위로 지정합니다. 지정한 값보다 이미지가 작은 경우 원본 이미지가 반환됩니다. 이미지의 높이 또는 너비 중 하나가 더 큰 경우에는 원래의 가로세로 비율을 유지한 채로 작은 항목에 맞게 크기가 조정됩니다. maxHeightPx 및 maxWidthPx 속성 모두 1부터 4800(포함) 사이의 정수가 허용됩니다. 값이 허용된 범위를 벗어나면 INVALID_VERSION 오류가 반환됩니다. maxHeightPx나 maxWidthPx 중 하나 이상을 지정해야 합니다. maxHeightPx와 maxWidthPx도 지정되지 않은 경우 INVALID_CONVERSION 오류가 반환됩니다. |
maxHeightPx |
선택사항입니다. 원하는 이미지의 최대 높이를 픽셀 단위로 지정합니다. 지정한 값보다 이미지가 작은 경우 원본 이미지가 반환됩니다. 이미지의 높이 또는 너비 중 하나가 더 큰 경우에는 원래의 가로세로 비율을 유지한 채로 작은 항목에 맞게 크기가 조정됩니다. maxHeightPx 및 maxWidthPx 속성 모두 1부터 4800(포함) 사이의 정수가 허용됩니다. 값이 허용된 범위를 벗어나면 INVALID_VERSION 오류가 반환됩니다. maxHeightPx나 maxWidthPx 중 하나 이상을 지정해야 합니다. maxHeightPx와 maxWidthPx도 지정되지 않은 경우 INVALID_CONVERSION 오류가 반환됩니다. |
skipHttpRedirect |
선택사항입니다. 설정된 경우 기본 HTTP 리디렉션 동작을 건너뛰고 텍스트 형식 (예: HTTP 사용 사례의 경우 JSON 형식) 응답을 렌더링합니다. 설정하지 않으면 HTTP 리디렉션이 실행되어 호출을 이미지 미디어로 리디렉션합니다. HTTP가 아닌 요청에서는 이 옵션이 무시됩니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
Places API의 사진 미디어입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "name": string, "photoUri": string } |
필드 | |
---|---|
name |
사진 미디어의 리소스 이름으로 |
photoUri |
사진을 렌더링하는 데 사용할 수 있는 단기 URI입니다. |