Places API의 일부인 장소 사진 (기존)은 애플리케이션에 고품질 사진 콘텐츠를 추가할 수 있는 읽기 전용 API입니다. 장소 사진 (기존)을 사용하면 장소 데이터베이스에 저장된 수백만 장의 사진에 액세스할 수 있습니다. 장소 세부정보 요청을 사용하여 장소 정보를 가져오면 관련 사진 콘텐츠에 대해 사진 참조가 반환됩니다. 장소 검색 (기존), 주변 검색 (기존), 텍스트 검색 (기존) 요청도 관련된 경우 장소당 하나의 사진 참조를 반환합니다. 그런 다음 장소 사진 (기존)을 사용하여 참조된 사진에 액세스하고 이미지를 애플리케이션에 가장 적합한 크기로 조정할 수 있습니다.
장소 사진 (기존) 요청
장소 사진 (기존) 요청은 다음 형식의 HTTP URL입니다.
https://maps.googleapis.com/maps/api/place/photo?parameters
검색 요청을 시작하기 위해서는 특정 매개변수가 필요합니다. URL에서와 마찬가지로 모든 매개변수는 앰퍼샌드 (&) 문자를 사용하여 구분합니다. 매개변수 목록과 가능한 값은 아래에 열거되어 있습니다.
필수 매개변수
-
photo_reference
사진을 고유하게 식별하는 문자열 식별자입니다. 사진 참조는 장소 검색 또는 장소 세부정보 요청에서 반환됩니다.
-
maxheight 또는 maxwidth
maxheight는 이미지의 최대 기본 높이를 픽셀 단위로 지정합니다. 이미지가 지정된 값보다 작으면 원본 이미지가 반환됩니다. 이미지가 어느 한쪽 크기에서 더 크면 원래 가로세로 비율로 제한된 두 크기 중 더 작은 크기에 맞게 조정됩니다.maxwidth는 이미지의 최대 기본 너비를 픽셀 단위로 지정합니다. 이미지가 지정된 값보다 작으면 원본 이미지가 반환됩니다. 이미지가 어느 한쪽 크기에서 더 크면 원래 가로세로 비율로 제한된 두 크기 중 더 작은 크기에 맞게 조정됩니다.maxheight및maxwidth속성은 모두1과1600사이의 정수를 허용합니다.maxheight또는maxwidth또는 둘 다 지정해야 합니다.
사진 참조
장소 사진 (기존)에 대한 모든 요청에는 장소 검색 (기존), 주변 검색 (기존), 텍스트 검색 (기존) 또는 장소 세부정보 (기존) 요청에 대한 응답으로 반환되는 photo_reference가 포함되어야 합니다. 장소에 관련 사진 콘텐츠가 있는 경우 이러한 요청에 대한 응답에는 photos[] 필드가 포함됩니다.
참고: 반환되는 사진 수는 요청에 따라 다릅니다.
- 장소 검색 (기존), 주변 검색 (기존) 또는 텍스트 검색 (기존) 요청은 배열에서 최대 하나의
photo요소를 반환합니다. - 장소 세부정보 (기존) 요청은 최대 10개의
photo요소를 반환합니다.
각 photo 요소에는 다음 필드가 포함됩니다.
photo_reference: 장소 사진 (기존) 요청을 실행할 때 사진을 식별하는 데 사용되는 문자열입니다.height: 이미지의 최대 높이입니다.width: 이미지의 최대 너비입니다.html_attributions[]: 필요한 저작자 표시가 포함되어 있습니다. 이 필드는 항상 존재하지만 비어 있을 수 있습니다.
장소 사진 (기존)에서 반환되는 사진은 비즈니스 소유자 및 사용자 제공 사진을 비롯한 다양한 위치에서 가져온 것입니다. 대부분의 경우 이러한 사진은 저작자 표시 없이 사용할 수 있거나 필수 저작권 표시가 이미지의 일부로 포함되어 있습니다. 하지만 반환된 photo 요소의 html_attributions 필드에 값이 포함된 경우 이미지를 표시할 때마다 애플리케이션에 추가 저작자 표시를 포함해야 합니다.
다음 예는 장소 세부정보 (기존) 요청을 보여줍니다.
curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"
응답의 photos[] 배열 예는 아래와 같습니다.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
}]
...
장소 사진 (기존) 예
아래는 예시 요청입니다. 이 요청은 참조된 이미지를 반환하며 최대 너비가 400픽셀이 되도록 크기를 조절합니다.
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q &key=YOUR_API_KEY
장소 사진 (기존) 응답
성공적인 장소 사진 (기존) 요청의 응답은 이미지입니다. 이미지 유형은 원래 제출된 사진 유형에 따라 다릅니다.
요청이 사용 가능한 할당량을 초과하면 서버는 HTTP 403 상태를 반환하고 아래 이미지를 표시하여 할당량이 초과되었음을 나타냅니다.
서버가 요청을 이해할 수 없으면 HTTP 400 상태를 반환합니다. 이는 잘못된 요청을 나타냅니다. 잘못된 요청의 가장 일반적인 이유는 다음과 같습니다.
- 제출된 사진 참조가 올바르게 지정되지 않았습니다.
- 요청에
maxwidth또는maxheight매개변수가 포함되지 않았습니다. maxwidth또는maxheight매개변수의 값이null로 설정되었습니다.photo_reference가 만료되었습니다.photo_reference가 만료되면 장소 세부정보 (기존), 장소 검색 (기존), 주변 검색 (기존) 또는 텍스트 검색 (기존)에 요청하여 업데이트된photo_reference값을 가져옵니다.