모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Maps JavaScript API 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Maps JavaScript API 및 관련 서비스 활성화
  3. 적합한 키 생성
계속

오류 메시지


Google Maps JavaScript API는 오류 및 경고 메시지를 window.console에 기록합니다. 다음 표는 Google Maps JavaScript API에 의해 반환될 수 있는 오류 코드와 그 원인 및 문제 해결 방법을 나타냅니다. 오류 메시지를 찾는 방법에 대해서는 브라우저에서 오류 확인 섹션을 참조하세요.

Google Maps JavaScript API 오류 코드

Google Maps JavaScript API를 로드하는 중에 오류가 발생하면, 아래 표를 참조하여 해당 오류 코드의 설명을 찾아보세요.

오류 코드 메시지 설명
InvalidKeyOrUnauthorizedURLMapError 제공된 Google API 키가 잘못되었거나 이 사이트가 키를 사용하도록 인증되지 않았습니다.

API를 로드하는 스크립트 요소에 포함된 API 키가 잘못되었거나 Google Maps JavaScript API를 로드하는 현재 URL이 허용된 참조 페이지 목록에 추가되지 않았습니다. Google API Console에서 API의 Google Maps JavaScript API를 활성화해야 할 수도 있습니다.

API 키 획득을 참조하세요.

NotLoadingAPIFromGoogleMapError Google Maps JavaScript API는 Google 서버에서 직접 다운로드해야 합니다.

Google Maps JavaScript API를 로드하는 스크립트 요소가 페이지에 올바로 포함되지 않았습니다. API가 올바르게 작동하려면 https://maps.googleapis.com에서 직접 로드되어야 합니다.

Maps API 로드를 참조하세요.

TOSViolationMapError 이 웹사이트는 Google Maps API 서비스 약관을 위반한 것 같습니다. The Google Maps API has been disabled for this website.

Google Maps APIs 서비스 약관을 미준수하여 애플리케이션이 차단되었으며, 여러 개의 이메일 알림이 이어집니다. 이러한 차단에 이의를 제기하고 구현 검토를 요청하려면, 이 양식을 작성하세요. 영업일 기준 며칠 이내에 이메일로 회신을 드리겠습니다.

Google Maps API 프리미엄 플랜 라이선스를 보유한 경우, Google Maps API 프리미엄 플랜 자격 증명을 사용하여 이 오류를 해결하세요. API 키 및 클라이언트 ID 가이드를 참조하세요.

UnauthorizedURLForClientIdMapError 이 URL은 제공된 Google Maps 클라이언트 ID를 사용하도록 승인되지 않았습니다.

이 스크립트 로드에 포함된 프리미엄 플랜 또는 Maps APIs for Work 클라이언트 ID가 잘못되었거나, 만료되었거나, Google Maps JavaScript API를 로드하는 현재 주소가 인증된 URL 목록에 추가되지 않았습니다.

인증된 URL 등록을 참조하세요.

Google Maps JavaScript API 개발자 오류 코드

Chrome JavaScript Console, Firefox Web Console 또는 브라우저의 다른 유사한 도구에서 오류가 발견되면 아래 표를 참조하여 오류 코드의 설명을 찾아보세요.

오류와 경고라는 두 가지 오류 코드 유형이 있습니다. 오류는 Google Maps JavaScript API를 로드하는 동안 발생한 심각한 문제를 나타냅니다. 페이지가 API를 올바로 로드하지 못하면, API가 해당 페이지에서 작동하지 않게 됩니다. 경고는 Google Maps JavaScript API 로드에 대한 추가 메시지입니다. 경고는 오류가 발생할 만한 사유를 설명하거나 Google Maps JavaScript API를 로드하는 코드에 있는 잠재적 문제를 제안합니다. 오류 없이 경고만 받았다면, API가 해당 페이지에서 올바르게 작동할 것입니다. 그러나 잠재적 문제를 해결하는 것이 좋습니다.

개발자 오류 코드 유형 설명
ApiNotActivatedMapError 오류

Google Maps JavaScript API는 API 프로젝트에서 활성화되지 않습니다. Google API Console에서 API의 Google Maps JavaScript API를 활성화해야 할 수도 있습니다.

API 키 획득을 참조하세요.

DeletedApiProjectMapError 오류

API 프로젝트가 Google API Console에서 삭제되었을 수 있습니다. JavaScript API 로더에 포함된 API 키를 생성했던 프로젝트를 확인하세요. 새 API 프로젝트를 생성하고 Google API Console에서 새 키를 가져올 수 있습니다.

API 키 획득을 참조하세요.

ExpiredKeyMapError 오류

API를 로드하는 스크립트 요소에 포함된 API 키가 만료되었습니다. Google API Console에서 새 API 키를 생성해야 할 수도 있습니다.

API 키 획득을 참조하세요.

InvalidClientIdMapError 오류

API를 로드하는 스크립트 요소에 포함된 클라이언트 ID가 잘못되었거나 만료되었습니다. 클라이언트 ID를 올바르게 사용하고 있는지 확인하세요. 클라이언트 ID는 "gme-" 접두사로 시작해야 합니다. 클라이언트 ID를 올바르게 사용하고 있는데도 이 오류가 보이면, 클라이언트 ID가 만료되었을 수 있습니다. Google 계정 관리자에게 문의하세요.

프리미엄 플랜 또는 Maps APIs for Work 라이선스가 없다면 API 키와 함께 client 매개변수 대신 key 매개변수를 사용해야 합니다.

클라이언트 ID를 참조하세요.

InvalidKeyMapError 오류

API를 로드하는 스크립트 요소에 포함된 API 키를 찾을 수 없습니다. 올바른 API 키를 사용하고 있는지 확인하세요. Google API Console에서 새 API 프로젝트를 생성할 수 있습니다.

API 키 획득을 참조하세요.

MissingKeyMapError 오류

API를 로드하는 스크립트 요소에 필수 인증 매개변수가 누락되었습니다. 표준 Maps JavaScript API를 사용 중인 경우, 올바른 API 키와 함께 key 매개변수를 사용해야 합니다. 프리미엄 플랜 고객의 경우, 클라이언트 ID와 함께 client 매개변수를 사용하거나 올바른 API 키와 함께 key 매개변수를 사용해야 합니다.

API 키 및 클라이언트 ID 가이드를 참조하세요.

ProjectDeniedMapError 오류

요청이 완료되지 않았습니다. Google API Console에서 오류에 대한 자세한 내용을 찾을 수 있습니다.

Google API Console을 참조하세요.

RefererDeniedMapError 오류

Google Maps APIs 서비스 약관을 미준수하여 애플리케이션이 차단되었으며, 여러 개의 이메일 알림이 이어집니다. 이러한 차단에 이의를 제기하고 구현 검토를 요청하려면, 이 양식을 작성하세요. 영업일 기준 며칠 이내에 이메일로 회신을 드리겠습니다.

RefererNotAllowedMapError 오류

Google Maps JavaScript API를 로드하는 현재 URL이 허용된 참조 페이지 목록에 추가되지 않았습니다. Google API Console에서 API 키의 참조 페이지 설정을 확인하세요.

Google API Console의 API 키를 참조하세요. 자세한 내용은 안전한 API 키 사용을 위한 모범 사례를 참조하세요.

OverQuotaMapError 오류

요청의 수가 Google Maps JavaScript API의 사용 제한을 초과했습니다. 일일 할당량이 다시 재설정되면 앱 요청이 다시 수행됩니다.

자세한 내용은 사용 제한 가이드를 참조하세요. 이 페이지에서는 또한 사용 제한을 더 높이는 방법에 대해 설명합니다.

ClientIdLooksLikeCryptoKey 경고

client 매개변수에 암호 키를 제공했을 수도 있습니다. 프리미엄 플랜 또는 Maps APIs for Work 라이선스가 있다면 클라이언트 ID를 client 매개변수로 지정하세요. Google Maps JavaScript API에서는 암호 키를 사용할 필요가 없습니다.

프리미엄 플랜 및 Maps APIs for Work 고객의 경우 클라이언트 ID 가이드를 참조하세요.

ClientIdLooksLikeKey 경고

client 매개변수에 API 키를 제공했을 수도 있습니다. 프리미엄 플랜 또는 Maps APIs for Work 라이선스가 있다면 클라이언트 ID를 client 매개변수로 지정하세요. Google Maps API 프리미엄 플랜를 보유한 경우 client 매개변수나 key 매개변수를 사용할 수 있습니다. 라이선스가 없을 경우 client 매개변수 대신 key 매개변수를 사용해야 합니다.

클라이언트 ID 및 API 키 가이드를 참조하세요.

InvalidChannel 경고

잘못된 channel 매개변수를 제공했을 수도 있습니다. channel은 마침표(.), 밑줄(_), 하이픈(-)을 포함한 ASCII 영숫자 문자열이어야 합니다. 유효한 channel 매개변수를 지정했는지 확인하세요.

보고 | Google Maps API 프리미엄 플랜를 참조하세요.

InvalidClientId 경고

client 매개변수에 정확한 클라이언트 ID가 포함되지 않은 것 같습니다. 클라이언트 ID는 "gme-"로 시작해야 합니다.

프리미엄 플랜 또는 Maps APIs for Work 고객의 경우 클라이언트 ID 가이드를 참조하세요.

InvalidKey 경고

API를 로드하는 스크립트 요소에 포함된 API 키가 잘못된 것 같습니다. 올바른 API 키를 사용하고 있는지 확인하세요. Google API Console에서 새 API 프로젝트를 생성할 수 있습니다.

API 키 획득을 참조하세요.

InvalidVersion 경고

스크립트 요소에 잘못된 버전 번호를 제공했을 수도 있습니다. 올바른 버전 번호를 사용하고 있는지 확인하세요.

버전 관리 | Google Maps JavaScript API를 참조하세요.

KeyLooksLikeClientId 경고 클라이언트 ID를 key 매개변수로 제공했을 수 있습니다. 프리미엄 플랜 또는 Maps APIs for Work 라이선스가 있다면 클라이언트 ID를 key 매개변수 대신 client 매개변수로 지정하세요. Google Maps API 프리미엄 플랜를 보유한 경우 client 매개변수나 key 매개변수를 사용할 수 있습니다. 라이선스가 없을 경우 client 매개변수 대신 key 매개변수를 사용해야 합니다.

클라이언트 ID 및 API 키 가이드를 참조하세요.

KeyLooksLikeCryptoKey 경고

암호 키를 key 매개변수로 제공했을 수 있습니다. 프리미엄 플랜 또는 Maps APIs for Work 라이선스가 있다면 클라이언트 ID를 client 매개변수로 지정하고 스크립트 요소에서 key 매개변수를 제거하세요. Google Maps JavaScript API에는 암호 키가 필요 없습니다. Google Maps API 프리미엄 플랜를 보유한 경우 client 매개변수나 key 매개변수를 사용할 수 있습니다. 라이선스가 없을 경우 Google API Console에서 무료 API 키를 얻을 수 있습니다.

클라이언트 ID 및 API 키 가이드를 참조하세요.

KeyLooksLikeProjectNumber 경고

프로젝트 번호를 key 매개변수로 제공했을 수 있습니다. 올바른 API 키를 사용하고 있는지 확인하세요. Google API Console에서 새 API 프로젝트를 생성할 수 있습니다.

API 키 획득을 참조하세요.

NoApiKeys 경고

API를 로드하는 스크립트 요소에 API 키가 없습니다. 유효한 API 키를 key 매개변수로 포함하세요. Google API Console에서 새 API 프로젝트를 생성할 수 있습니다.

API 키 획득을 참조하세요.

RetiredVersion 경고

스크립트 요소에 사용이 중단된 버전을 제공했을 수도 있습니다. 3.0 - 3.24 버전은 사용이 중단되었고 대신 3.25을 받았을 수도 있습니다. 이용 가능한 버전 중 하나를 사용하도록 애플리케이션을 업데이트하세요.

버전 관리 | Google Maps JavaScript API를 참조하세요.

SensorNotRequired 경고

이제 Google Maps JavaScript API에서 sensor 매개변수가 더 이상 필요하지 않습니다. Google Maps JavaScript API는 올바로 작동하겠지만, 스크립트 요소에서 sensor를 제거하는 것이 좋습니다.

SignatureNotRequired 경고

signature 매개변수는 Google Maps JavaScript API에서 필요하지 않습니다. Google Maps JavaScript API는 올바로 작동하겠지만, 보안 위험이 발생할 수 있습니다. 스크립트 요소에서 제거하세요.

SignedInDeprecated 경고

signed_in 매개변수는 지원 중단되며 향후 버전의 Google Maps JavaScript API에서는 무시됩니다. 로그인 모드가 지원 중단된 후 Google Maps JavaScript API 작동이 차단되지는 않지만, 현재의 로그인 기능에 따라 애플리케이션 동작이 변경될 수도 있습니다.

애플리케이션을 검토하고 향후 변경에 대한 자세한 내용은 로그인 지도 | Google Maps JavaScript API를 참조하세요.

UrlAuthenticationCommonError 오류

이 페이지의 기타 범주에 맞지 않는 오류가 발생했습니다. 그 원인은 일시적인 문제일 수 있습니다. 잠시 후에 요청을 재시도하세요. 그래도 문제가 해결되지 않으면, 개발자 가이드를 검토하여 요청 형식이 올바른지 확인하세요.

브라우저에서 오류 확인

Google Maps JavaScript API는 오류 메시지를 window.console에 기록합니다. 이 섹션에서는 Google Chrome에서 window.console 출력을 확인할 수 있는 방법에 대해 설명합니다. 다른 브라우저를 사용 중인 경우 해당 브라우저의 개발자 문서를 참조하세요. 참고로, 다음은 다른 브라우저에서 window.console 출력을 확인할 수 있는 도구 목록입니다.

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

  1. 개발자 도구를 열려면 메뉴 아이콘 > More Tools > Developer Tools를 선택합니다.
  2. JavaScript 콘솔을 열려면 키보드에서 ESC 키를 누릅니다. ESC 키를 누르면 JavaScript 콘솔이 전환됩니다. 콘솔을 닫은 경우 ESC 키를 눌러 다시 엽니다.

Google Maps JavaScript API를 로드할 때 오류나 경고가 발생한 경우, 콘솔에 하나 이상의 줄로 나타납니다. 오류나 경고 메시지의 형식은 다음과 같습니다.

Google Maps API error: [ERROR CODE] [Link to API document]
또는
Google Maps API warning: [ERROR CODE] [Link to API document]

위의 오류 코드 표를 확인하여 오류 메시지에서 오류 코드를 찾을 수 있습니다. 또한 오류 메시지에 대한 세부정보는 메시지에 링크된 API 문서에서 찾을 수 있습니다.

참고: 프로그래밍 방식으로 인증 오류를 수신할 수 있습니다.

다음에 대한 의견 보내기...

Google Maps JavaScript API
Google Maps JavaScript API
도움이 필요하시나요? 지원 페이지를 방문하세요.