스트리트 뷰 Static API의 오류 메시지

요청이 실패하면 스트리트 뷰 Static API가 오류 또는 경고를 반환합니다. 이 가이드에서는 오류 메시지를 설명하고 오류를 해결하는 방법을 안내합니다.

잘못된 요청

잘못된 요청의 경우 스트리트 뷰 정적 API는 HTTP 4xx 상태 코드와 문제를 설명하는 메시지를 반환합니다. 다음 표에는 이러한 오류 조건의 예가 나와 있습니다. 가능한 오류의 전체 목록은 아닙니다. API에서 반환된 실제 오류 코드와 메시지를 확인하여 특정 문제의 세부정보를 확인할 수 있습니다.

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

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

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

스트리트 뷰 이미지 대신 오류 이미지가 표시됨
그림: 스트리트 뷰 이미지 대신 오류 이미지가 표시됨

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

키리스 오류 및 해결 방법
사용량 한도 오류: 제공된 일일 지도 로드 한도를 초과함 API 키 없이 스트리트 뷰 Static API를 사용하고 있습니다. 이 오류를 해결하려면 다음 단계를 완료하세요.
  1. API 키 가져오기
  2. 결제 사용 설정
  3. URL 서명하기
사용량 한도 오류: 요청 URL에 디지털 서명이 누락됨 요청에 필수 디지털 서명이 누락되었습니다. 이 오류를 해결하려면 URL에 서명하세요.