이 페이지에서는 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 상태 코드만 보고됩니다.
확인할 수 있습니다 이 섹션에서는 Cloud Shell에서 콘솔 출력을 확인하는 방법을 설명합니다.
Chrome 다른 브라우저를 사용 중인 경우 개발자에게 문의하여
참조하세요. 다음은 Google Kubernetes Engine에서
다른 브라우저에서 콘솔 출력을 확인하세요
- Console(콘솔)(Internet Explorer)
- Web Console(웹 콘솔)(Firefox)
- 원격 디버깅(Android)
- Web Inspector(웹 검사기)(iOS)
Chrome에서는 JavaScript 콘솔 다음과 같이 콘솔 출력을 확인합니다.
- 메뉴 아이콘 > 개발자 도구를 선택하여 개발자 도구를 엽니다. 도구 더보기 > 개발자 도구.
- JavaScript 콘솔을 열려면 상단의 콘솔 탭을 클릭합니다. 개발자 도구 창을 엽니다. 또한 ESC 키를 사용하여 JavaScript 콘솔