이 페이지에서는 Maps Embed API에서 반환할 수 있는 오류 메시지를 설명합니다. 오류가 발생하면 Maps Embed API는 지도 대신 오류 메시지 텍스트를 표시합니다. 또한 특정 오류 조건이 발생하여 워터마크 처리된 어두운 지도가 표시될 수 있습니다.
잘못된 요청
요청이 잘못된 경우 Maps Embed API는 HTTP 4xx
상태 코드와 문제를 설명하는 메시지를 반환합니다. 아래는 이러한 오류 상황의 예를 보여줍니다. 참고: 이 목록은 발생할 수 있는 오류의 전체 목록이 아닙니다. 구체적인 문제에 관한 자세한 내용은 API에서 반환하는 실제 오류 코드와 메시지를 확인하세요.
오류 상황의 예 | 상태 코드 |
---|---|
요청에 잘못된 매개변수가 포함되어 있거나 필수 매개변수가 누락되었습니다. 예를 들어 zoom 매개변수가 숫자 값의 예상 범위를 벗어났거나, 요청에서 필수 매개변수가 누락되었습니다. |
400 BAD REQUEST |
요청에 포함된 API 키가 잘못되었습니다. | 403 FORBIDDEN |
API 키 및 QPS 오류
API 키 및 QPS 오류는 잘못된 요청으로 처리됩니다. 가능한 원인은 다음과 같습니다.
- API 키가 없거나 잘못되었습니다. 이 오류를 해결하려면 요청에 유효한 API 키가 포함되어 있는지 확인하세요. API 키를 가져옵니다.
- 프로젝트에서 Maps Embed API가 사용 설정되지 않았습니다. API 사용 설정 및 중지에 대해 알아보기
- API 키에 제한사항 위반이 있습니다. API 키 권장사항 자세히 알아보기
결제 및 HTTP 리퍼러 오류
다음 중 하나에 해당하면 '개발 전용' 워터마크가 표시된 어두운 지도 또는 '음화' 스트리트 뷰 이미지가 반환됩니다.
- 계정에서 결제가 사용 설정되지 않았습니다. 결제를 사용 설정합니다.
- 제공된 결제 수단이 잘못되었습니다 (예: 신용카드가 만료됨). 이 문제를 해결하려면 Google Cloud 콘솔로 이동하여 유효한 결제 수단을 제공했는지 확인하세요.
- 직접 적용한 일일 한도를 초과했습니다. 일일 청구 가능 한도를 확인하거나 변경하는 방법 알아보기
- 요청에 HTTP 리퍼러가 없으며 리퍼러 제한 API 키를 사용하고 있습니다. 리퍼러 추가에 대해 자세히 알아보기
브라우저에서 오류 확인
결제 및 HTTP 리퍼러 오류의 경우 Maps Embed API는 window.console
에 오류 메시지를 작성합니다. 잘못된 요청 (API 키 및 QPS 오류 포함)의 경우 HTTP 4xx
상태 코드만 콘솔에 보고됩니다. 이 섹션에서는 Chrome에서 콘솔 출력을 확인하는 방법을 설명합니다. 다른 브라우저를 사용 중인 경우 브라우저의 개발자 문서를 확인하세요. 참고로 다음은 다른 브라우저에서 콘솔 출력을 확인하는 도구 목록입니다.
- Console(콘솔)(Internet Explorer)
- Web Console(웹 콘솔)(Firefox)
- 원격 디버깅(Android)
- Web Inspector(웹 검사기)(iOS)
Chrome에서는 다음과 같이 JavaScript 콘솔을 사용하여 콘솔 출력을 확인할 수 있습니다.
- 개발자 도구를 열려면 메뉴 아이콘 > More Tools > Developer Tools를 선택합니다.
- 자바스크립트 콘솔을 열려면 개발자 도구 창 상단에 있는 콘솔 탭을 클릭합니다. ESC 키를 사용하여 JavaScript 콘솔을 전환할 수도 있습니다.