오류 메시지

이 페이지에서는 Maps Embed API에서 반환할 수 있는 오류 메시지를 설명합니다. 오류가 발생하면 Maps Embed API는 지도 대신 오류 메시지 텍스트를 표시합니다. 또한 특정 오류 조건이 발생하여 워터마크 처리된 어두운 지도가 표시될 수 있습니다.

잘못된 요청

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

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

API 키 및 QPS 오류

API 키 및 QPS 오류는 잘못된 요청으로 처리됩니다. 가능한 원인은 다음과 같습니다.

결제 및 HTTP 리퍼러 오류

다음 중 하나에 해당하면 '개발 전용' 워터마크가 표시된 어두운 지도 또는 '음화' 스트리트 뷰 이미지가 반환됩니다.

브라우저에서 오류 확인

결제 및 HTTP 리퍼러 오류의 경우 Maps Embed API는 window.console에 오류 메시지를 작성합니다. 잘못된 요청 (API 키 및 QPS 오류 포함)의 경우 HTTP 4xx 상태 코드만 콘솔에 보고됩니다. 이 섹션에서는 Chrome에서 콘솔 출력을 확인하는 방법을 설명합니다. 다른 브라우저를 사용 중인 경우 브라우저의 개발자 문서를 확인하세요. 참고로 다음은 다른 브라우저에서 콘솔 출력을 확인하는 도구 목록입니다.

Chrome에서는 다음과 같이 JavaScript 콘솔을 사용하여 콘솔 출력을 확인할 수 있습니다.

  1. 개발자 도구를 열려면 메뉴 아이콘 > More Tools > Developer Tools를 선택합니다.
  2. 자바스크립트 콘솔을 열려면 개발자 도구 창 상단에 있는 콘솔 탭을 클릭합니다. ESC 키를 사용하여 JavaScript 콘솔을 전환할 수도 있습니다.