Street View Static API의 오류 메시지

Street View Static API는 문제가 발생할 때 오류나 경고를 전송할 수 있습니다. 이 가이드에서는 각 오류 메시지를 설명하고 오류 해결 방법에 대한 추가 안내를 제공합니다.

잘못된 요청

잘못된 요청의 경우 Street View Static API는 HTTP 4xx 상태 코드와 문제를 설명하는 메시지를 반환합니다. 아래는 이러한 오류 상황의 예를 보여줍니다. 참고: 가능한 오류의 전체 목록이 아닙니다. 구체적인 문제에 대한 자세한 내용은 API에서 반환한 실제 오류 코드와 메시지를 확인하세요.

오류 상황의 예 상태 코드
요청에 잘못된 매개변수가 포함되었거나 필수 매개변수가 누락되었습니다. 예를 들어 size 매개변수가 숫자 값의 예상 범위 내에 있지 않거나 요청에서 누락되었습니다. 400 BAD REQUEST
요청에 포함된 API 키가 잘못되었습니다. 403 FORBIDDEN

스트리트 뷰 이미지가 표시되지 않는 오류

요청이 유효하지만 스트리트 뷰 이미지가 표시되지 않도록 하는 또 다른 오류가 발생하면 Street View Static API는 오류에 따라 스트리트 뷰 이미지 대신 텍스트나 오류 이미지를 반환합니다. 이러한 오류 상황의 예는 애플리케이션이 사용량 한도를 초과하는 경우입니다.

지도 대신 표시된 오류 이미지
그림: 스트리트 뷰 이미지 대신 표시되는 오류 이미지

API 키 없이 Street View Static API를 사용하거나 계정에서 결제가 사용 설정되지 않은 경우에는 페이지에 스트리트 뷰 이미지 대신 오류 이미지가 표시되고 오류 유형을 나타내는 링크가 표시됩니다. 예: &quotggco/streetviewerror/key"

키 없는 오류 및 솔루션
사용 제한 오류: 제공된 일일 지도 로드 제한 초과 API 키 없이 Street View Static API를 사용하고 있습니다. 문제를 해결하려면 다음을 수행해야 합니다.
  1. API 키 가져오기
  2. 결제 사용 설정
  3. URL 서명
사용량 한도 오류: 요청 URL에 디지털 서명이 없습니다. 요청에 디지털 서명이 없습니다 (필수). 해결하려면 URL에 서명하세요.