소개
Street View Static API 메타데이터 요청은 스트리트에 대한 데이터를 제공합니다. 파노라마를 봅니다. 메타데이터를 사용하면 스트리트 뷰 이미지가 다른 곳에 특정 위치에서 사용할 수 있을 뿐만 아니라 위도 및 경도 좌표, 파노라마 ID, 사진이 촬영된 날짜 이미지 저작권 정보가 표시됩니다. 이 metadata를 사용하면 애플리케이션의 오류 동작을 맞춤설정할 수 있습니다.
Street View Static API 메타데이터 요청은 있습니다. 메타데이터를 요청할 때 할당량이 소모되지 않습니다. <ph type="x-smartling-placeholder"></ph> 할당량은 다음 명령어를 사용하여 이미지를 로드할 때만 소비됩니다. Street View Static API.
스트리트 뷰 이미지 메타데이터를 요청할 때 파노라마 이미지는 50미터까지 정확합니다.
이미지 메타데이터에 액세스
스트리트 뷰 이미지 메타데이터 요청은 다음 형식의 HTTP URL입니다.
https://maps.googleapis.com/maps/api/streetview/metadata?parameters
URL의 표준에 따라 모든 매개변수는 앰퍼샌드(&) 기호로 구분됩니다. (&) 문자를 입력할 수 있습니다.
메타데이터 요청의 필수 매개변수
메타데이터 요청은 동일한 URL 매개변수 Street View Static API 이미지 요청과 같지만 다음 매개변수가 필요합니다.
다음 중 하나를 수행합니다.
location
— 텍스트 문자열 (예:Chagrin Falls, OH
)일 수 있음 또는 쉼표로 구분된 위도 및 경도 좌표 쌍 (40.457375,-80.009353
)입니다.
또는
pano
: 특정 파노라마 ID입니다. 파노라마는 시간이 지남에 따라 ID가 변경될 수 있으므로 이 ID를 유지하지 않습니다. 대신 위치 주소를 저장하거나 위도 및 경도 좌표를 사용하여 파노라마 ID를 새로고침할 수 있습니다. 대상 자세한 내용은 삭제된 파노라마 ID 새로고침을 참조하세요.
또한:
key
및signature
: API 키는 다음을 인증하는 데 필요합니다. 합니다. 디지털 서명도 특정한 경우에는 필요합니다. 항상 권장됩니다. 자세한 내용은 키 및 서명을 가져옵니다.
필수 매개변수만 포함된 메타데이터 요청은 다음과 같습니다.
https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
또는 다음과 같이 입력할 수 있습니다.
https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
삭제된 파노라마 ID 새로고침
파노라마 ID를 가져오고 ZERO_RESULTS
또는
값이 없는 경우 파노라마 ID가 삭제되어 새로 고쳐야 합니다.
사용한 위치 주소 또는 위도와 경도 좌표를 저장합니다. 파노라마 ID를 가져와서 필요할 때 새로고침할 수 있습니다.
파노라마 ID가 변경되었음을 감지하면 원래 위치를 사용합니다. 위도와 경도 좌표를 사용하여 가장 가까운 새 파노라마 ID를 얻습니다.
메타데이터 요청의 선택적 매개변수
메타데이터 요청에 size
매개변수를 포함할 수 있습니다.
heading
, fov
, pitch
이러한 매개변수는
파노라마에 대한 데이터 또는 발견된 파노라마입니다.
API를 사용하면
이미지 요청
을 사용하면 특정 이미지와 관련된 메타데이터 요청을 보다 쉽게 구성할 수 있습니다.
메타데이터 요청의 경우 API는 선택적 매개변수를 무시하고
선택을 합니다. 이러한 매개변수 사용에 대한 자세한 내용은
Street View Static API 개발자 가이드
응답 형식
메타데이터 응답은 JSON 형식으로만 반환됩니다.
예
예 1: 파노라마 발견됨
다음 URL은 동일한 있습니다.
메타데이터 요청 및 응답
https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{ "copyright" : "© 2017 Google", "date" : "2016-05", "location" : { "lat" : 48.85783227207914, "lng" : 2.295226175151347 }, "pano_id" : "tu510ie_z4ptBZYo2BGEJg", "status" : "OK" }
누락된 이미지가 예상되는 이미지 요청 및 응답
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
예 2: 파노라마를 찾을 수 없음
다음 URL은 지정된 위치 또는 근처에서 (을)를 찾을 수 없습니다.
메타데이터 요청 및 응답
https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{ "status" : "ZERO_RESULTS" }
이미지 요청 및 응답
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
상태 코드
메타데이터 응답 객체 내의 status
필드에는
문제 해결에 도움이 되는 디버깅 정보가 포함될 수 있습니다.
스트리트 뷰 요청이 작동하지 않는 이유. status
필드에는
다음 값:
상태 | 설명 |
---|---|
"OK" |
오류가 발생하지 않았음을 나타냅니다. 파노라마가 발견되고 메타데이터가 반환합니다. |
"ZERO_RESULTS" |
제공된 위치 근처에서 파노라마를 찾을 수 없음을 나타냅니다. 이 응답은 존재하지 않거나 잘못된 파노라마 ID를 제공하는 경우에 발생할 수 있습니다. [삭제된 파노라마 ID 새로고침](#refresh-pano)을 참조하세요. |
"NOT_FOUND" |
location 에 제공된 주소 문자열을 나타냅니다.
매개변수를 찾을 수 없습니다. 이 메시지는 주소가 존재하지 않는 경우에 표시될 수 있습니다.
나타냅니다. |
"OVER_QUERY_LIMIT" |
일일 할당량 또는 초당 할당량을 초과했음을 나타냅니다. 지정할 수 있습니다. |
"REQUEST_DENIED" |
요청이 거부되었음을 나타냅니다. 이 메시지는 요청을 승인하지 않거나 Street View Static API가 API 키가 포함된 Google Cloud 콘솔 프로젝트입니다. |
"INVALID_REQUEST" |
일반적으로 쿼리 매개변수 (주소, 위도 및 경도 좌표 또는 구성요소)가 누락된 경우 |
"UNKNOWN_ERROR" |
서버 오류로 인해 요청을 처리하지 못했음을 나타냅니다. 이 문제는 대부분 일시적인 문제입니다. 다시 시도하면 요청이 성공할 수도 있습니다. |
추가 정보
Street View Static API 사용에 대한 자세한 내용은 다른 Google 지도 API 제품에 대한 자세한 내용은 지도 API 지원 페이지.