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