스트리트 뷰 이미지 메타데이터

소개

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 새로고침을 참조하세요.

또한:

  • keysignature: API 키는 다음을 인증하는 데 필요합니다. 합니다. 디지털 서명도 특정한 경우에는 필요합니다. 항상 권장됩니다. 자세한 내용은 키 및 서명을 가져옵니다.

필수 매개변수만 포함된 메타데이터 요청은 다음과 같습니다.

https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=

또는 다음과 같이 입력할 수 있습니다.

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=

삭제된 파노라마 ID 새로고침

파노라마 ID를 가져오고 ZERO_RESULTS 또는 값이 없는 경우 파노라마 ID가 삭제되어 새로 고쳐야 합니다.

  1. 사용한 위치 주소 또는 위도와 경도 좌표를 저장합니다. 파노라마 ID를 가져와서 필요할 때 새로고침할 수 있습니다.

  2. 파노라마 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 지원 페이지.