이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Google Maps Platform FAQ

시작하기

Google Maps Platform이란 무엇인가요?

Google Maps Platform은 개발자가 모바일 앱 및 웹페이지에 Google 지도를 삽입하거나 Google 지도에서 데이터를 가져오기 위해 사용할 수 있는 API 및 SDK의 모음입니다. Google Maps Platform에는 여러 가지 서비스가 포함되어 있습니다. 필요에 따라 다음 API 또는 SDK 중 하나만 사용하거나 여러 API와 SDK를 조합하여 사용할 수 있습니다.

지도:

경로:

장소:

환경:

Google Maps Platform을 시작하려면 어떻게 해야 하나요?

Google Maps Platform 시작하기를 참고하세요.

어떤 API가 필요한가요?

필요한 기능에 적합한 API를 찾으려면 API 선택 도구를 이용하세요.

내 사이트에서 API를 사용하려면 어떻게 해야 하나요?

관심 있는 특정 API 또는 SDK의 개요, 개발자, 시작 가이드를 참고하세요. 예를 들어 Android용 Maps SDK 또는 Maps JavaScript API 가이드를 참고하세요.

Google Maps Platform은 어떤 국가에 적용되나요?

Google 지도 팀은 꾸준히 새로운 지도 데이터를 제공하고 전 세계로 서비스 지역을 확대하고 있습니다. 최신 서비스 지역 정보는 Google 지도 서비스 지역 데이터를 참고하세요. 페이지 상단의 필터 상자로 데이터를 필터링할 수 있습니다. 데이터 제공업체와의 라이선스 계약이 변경되면 서비스 지역 데이터가 변경될 수 있습니다.

참고 항목:

영어가 아닌 언어로 Google Maps Platform 제품을 표시하려면 어떻게 해야 하나요?
대중교통 경로는 어느 국가에서 사용할 수 있나요?

Google Maps Platform 제품을 사용하지 않고도 내 사이트에 Google 지도를 넣을 수 있나요?

예. 이제 프로그램을 작성하거나 Google Maps Platform을 사용하지 않고도 Google 지도에 현재 표시된 지도를 웹사이트나 블로그에 삽입할 수 있습니다. 자세한 내용은 여기를 참고하세요.

휴대기기에 지도 애플리케이션을 제공하려면 어떻게 해야 하나요?

Android 애플리케이션에서 지도를 통합하려면 Android용 Maps SDK를 사용하세요.

네이티브 iOS 애플리케이션에서 지도를 통합하려면 iOS용 Maps SDK를 사용하세요.

Maps JavaScript API는 휴대기기에 맞게 개발되었으며 데스크톱 및 Apple iPhone과 같이 JavaScript가 완전히 구현된 웹브라우저가 포함된 기기 모두를 대상으로 하는 브라우저 애플리케이션에 적합합니다.

Maps JavaScript API를 사용하는 데 적합하지 않은 기기를 대상으로 하는 애플리케이션의 경우에는 Maps Static API에서 마커와 다중선을 포함한 지도 이미지를 GIF, JPG, PNG 형식으로 제공합니다. 브라우저 기반 애플리케이션의 외부에서 Maps Static API를 사용하려면 지도 이미지가 Google 지도와 연결되어 있어야 합니다.

Maps JavaScript API와 Maps Embed API는 어떤 웹브라우저를 지원하나요?

Maps JavaScript API와 Maps Embed API는 다음과 같은 웹브라우저를 지원합니다.

데스크톱

Microsoft Edge 최신 버전(Windows), IE 모드 제외
Firefox 최신 주요 안정화 버전 두 가지(Windows, macOS, Linux)
Chrome 최신 주요 안정화 버전 두 가지(Windows, macOS, Linux)
Safari 최신 주요 안정화 버전 두 가지(macOS)

Android

Chrome 최신 버전(Android 4.1 이상)
Chrome WebView(Android 4.4 이상)

iOS

모바일용 Safari(최신 및 이전 주요 iOS 버전)
UIWebView 및 WKWebView(iOS의 최신 및 이전 주요 버전)
iOS용 Chrome 최신 버전

Maps JavaScript API에서 지도를 인쇄할 수 있나요?

Maps JavaScript API에서는 지도를 인쇄할 수 없습니다. 일반적으로 사용되는 브라우저에서 인쇄 기능이 일관적으로 지원되지 않기 때문입니다.

Google Maps Platform 제품에 변경사항이 있을 때 알림을 받으려면 어떻게 해야 하나요?

다양한 Google Geo 개발자 제품 및 서비스에서 최신 업데이트를 받아보려면 Google Maps Platform 블로그를 구독해야 합니다.

기술 지원팀에 문의하려면 어떻게 해야 하나요?

이용 가능한 지원 옵션에 대한 자세한 내용은 Google Maps Platform 지원 및 리소스를 참고하세요.

언제 기술 지원을 이용할 수 있나요?

'서비스 이용 불가' 문제의 경우 지역 공휴일을 제외하고 주중 5일 24시간(도쿄 시간으로 월요일 오전 9시부터 태평양 시간으로 금요일 오후 5시까지) 지원팀에 문의할 수 있습니다.

Google 계정에 대한 액세스 권한을 복구하려면 어떻게 해야 하나요?

Google 계정(예: [email protected] 또는 [email protected])에 액세스할 수 없는 경우 비밀번호를 검색하거나 재설정하여 계정 액세스 권한을 복원해 보세요. Google 계정 도움말의 Google 계정 또는 Gmail을 복구하는 방법을 참고하세요.

참고: G Suite 계정의 액세스 권한을 복원하려면 조직 관리자에게 계정을 삭제 취소해달라고 요청하세요.

특정 프로젝트에 대한 액세스 권한을 복구하려면 어떻게 해야 하나요?

Google Maps Platform 구현을 관리하는 프로젝트에 액세스할 수 없는 경우 액세스 권한을 복구해 보세요.

프로젝트에 연결된 Google 계정에 액세스할 수 있는 경우:

프로젝트 소유자를 알고 있고 Google 계정에 액세스할 수 있는 경우: 프로젝트 소유자에게 프로젝트 소유자나 프로젝트 편집자로 추가해달라고 요청하세요.
- 프로젝트가 조직의 일부인 경우: 조직 관리자에게 연락하여 프로젝트 소유자로 추가해달라고 요청하세요.
현재 프로젝트 소유자를 모르는 경우: 누가 프로젝트 소유자인지 모르거나 프로젝트 소유자에게 연락할 수 없는 경우 지원팀에 문의하여 프로젝트를 복구할 수 있는 추가 옵션에 대해 알아보세요.

프로젝트에 연결된 Google 계정에 액세스할 수 없는 경우:

Google 계정에 액세스할 수 없는 경우: 계정의 사용자 이름 또는 비밀번호를 복구해 보세요.
Google 계정의 액세스 권한을 복구할 수 없는 경우: 새 Google 계정을 만든 다음 기존 프로젝트 소유자에게 연락하여 프로젝트에 새 Google 계정을 추가해달라고 요청하세요.

ARM 기반의 Mac에서 iOS용 지도 및 Places SDK를 사용할 수 있나요?

새로운 ARM 기반의 Mac에서 개발하는 것이 가능하기는 하지만, 실제 iOS 기기에서 빌드 및 실행해야 합니다. 이러한 한계를 보완하기 위해 Google에서는 시뮬레이터를 통한 개발에 지원 기능을 추가하는 방안을 고려하고 있습니다.

서비스 약관 이해하기

Google Maps Platform 제품의 서비스 약관은 어떤 내용인가요?

Google Maps Platform 서비스 약관은 다음 페이지에서 확인할 수 있습니다.

https://cloud.google.com/maps-platform/terms

내 사이트가 Google Maps Platform 서비스 약관을 준수하나요?

사이트가 Google Maps Platform 서비스 약관을 준수하는 한 애플리케이션에서 Google Maps Platform을 사용할 수 있습니다.

하지만 특정 도시에서 불법 약물을 구매하거나 기타 불법 활동이 가능한 장소를 표시하는 지도 등 Google Maps Platform을 사용할 수 없는 경우도 있습니다. Google은 개인 정보를 존중하므로 개인의 비공개 정보를 식별하기 위해 Google Maps Platform을 사용해서는 안 됩니다.

애플리케이션을 개발하여 출시하기 전에 애플리케이션이 Google Maps Platform 서비스 약관을 준수하는지 직접 판단해야 합니다. Google 엔지니어는 기술 지원만 제공할 수 있으며 법률적 조언을 제공할 자격이 없습니다. Google은 언제든지 서비스 사용을 정지하거나 종료할 권리를 보유하고 있으므로 지도 API 약관을 주의 깊게 읽어보세요.

지도 타일 및 위성 이미지에 직접 액세스할 수 있나요?

Google Maps Platform 이외의 메커니즘을 통해(예: 자체 매핑 API를 만들거나 일괄 타일 다운로드 스크립트를 사용하여) 지도 타일 또는 위성 이미지에 액세스할 수 없습니다. Google Maps Platform 외부에서는 애플리케이션의 타일 액세스가 차단됩니다. 자세한 내용은 Google Maps Platform 서비스 약관을 참고하세요.

Google Maps Platform 제품을 추적 애플리케이션에 사용할 수 있나요?

애플리케이션이 Google Maps Platform 서비스 약관을 준수할 경우 Google Maps Platform 제품으로 실시간 데이터를 표시(추적)하는 데는 제한이 없습니다.

웹 애플리케이션이 아닌 애플리케이션에서 Google 지도를 사용할 수 있나요?

예. 이제 Google Maps Platform 서비스 약관의 다른 제한사항을 준수할 경우 웹 애플리케이션이 아닌 애플리케이션에서 Google Maps Platform 제품을 사용할 수 있습니다.

Maps JavaScript API는 지원되는 브라우저에서 실행되는 경우에만 지원됩니다.

비밀번호로 보호되는 사이트에서 Google Maps Platform 제품을 사용할 수 있나요?

예. Google 지도, 경로, 장소, 환경 서비스를 비공개 액세스 애플리케이션과 함께 사용할 수 있습니다. 자세한 내용은 Google Maps Platform 서비스 약관을 참고하세요.

Google Maps Platform 데이터를 문서에 포함하는 애플리케이션을 만들 수 있나요?

애플리케이션에서 전자 또는 인쇄된 형식으로 문서를 생성하는 경우 이미지를 포함하여 Google Maps Platform의 데이터가 문서에 포함되지 않을 수도 있습니다. 자세한 내용은 Google Maps Platform 서비스 약관의 '스크래핑 없음' 섹션을 참고하세요.

Google 검색결과에 내 콘텐츠가 포함되지 않도록 하려면 어떻게 해야 하나요?

Google은 더 이상 이 데이터를 수집하지 않습니다. indexing 매개변수 사용은 지원 중단되었으며 효과가 없습니다. 이 매개변수를 명시적으로 선택 해제할 필요는 없지만 가급적 빨리 삭제하시기 바랍니다.

검색결과에서 페이지 또는 사이트를 삭제하려면 웹마스터 고객센터에 나와 있는 안내를 따르세요.

내 웹사이트에서 저장하고 제공하는 Maps Static API를 사용하여 지도 이미지를 생성할 수 있나요?

웹사이트에서 Maps Static API를 사용하여 생성된 이미지는 저장 및 제공할 수 없습니다. 정적 지도 이미지가 필요한 모든 웹페이지는 HTML img 태그의 src 속성 또는 HTML div 태그의 CSS background-image 속성을 Maps Static API에 직접 연결하여 모든 지도 이미지가 웹페이지의 HTML 콘텐츠 내에 표시되고 Google에서 최종 사용자에게 직접 제공할 수 있도록 해야 합니다.

사용량 한도 및 결제

프로젝트에 대해 결제를 설정하려면 어떻게 해야 하나요?

Google Maps Platform 시작하기를 참고하세요.

Google Cloud Platform 무료 등급 고객이 유료 계정으로 업그레이드하려면 어떻게 해야 하나요?

Google Cloud Platform 무료 등급 이 프로그램은 고객에게 Google Maps Platform (GMP) API를 포함한 모든 Google Cloud 서비스에 사용할 수 있는 $300의 무료 체험판을 제공합니다. 무료 체험 기간이 종료된 후에도 이 서비스를 계속 사용하려면 유료 계정으로 업그레이드해야 합니다. 유료 계정으로 업그레이드 하려면 Cloud 콘솔로 이동하세요.

Google Maps Platform에 사용량 한도가 있나요?

Google Maps Platform 제품에 대한 일일 요청 횟수에는 제한이 없으며 사용량 한도만 최대 '분당 쿼리 수'(QPM)와 관련이 있습니다.

Distance Matrix의 경우 한도는 분당 이벤트 수 (EPM) 단위로 설정되며 할 수 있습니다.

Routes:Compute Route Matrix의 경우 한도는 분당 요소 수 (EPM)이며, 요청의 요소는 (출발지 수 x 목적지 수)와 같습니다.

Navigation SDK의 경우 요청의 각 대상은 별도의 쿼리로 계산됩니다.

다음 표에는 각 API의 사용량 한도가 나와 있습니다.

API	사용량 한도
Address Validation	6,000 QPM
항공 뷰: 동영상 조회	180 QPM 및 100,000 QPD
항공 뷰: 동영상 렌더링	100 QPM 및 100 QPD
공기질	6,000 QPM
Directions	3,000 QPM
Distance Matrix	60,000 EPM
Dynamic Maps	30,000 QPM
Elevation	6,000 QPM
Geocoding	3,000 QPM
Geolocation	6,000 QPM
Map Tiles API: 2D 타일 및 스트리트 뷰 타일	6,000 QPM 및 15,000 QPD
Map Tiles API: 실사 3D 타일	10000 QPD
Map Tiles API: 실사 3D 타일: 렌더기	12,000 QPM
탐색: 대상 요청 설정	30,000 QPM
장소	6,000 QPM
Pollen	6,000 QPM
Roads	30,000 QPM
Routes: Compute Routes	3,000 QPM
Routes: Compute Route Matrix	3,000 EPM
태양광	600 QPM
Static Maps	30,000 QPM
Street View Image API	30,000 QPM
Time Zone	30,000 QPM

비용을 통제하기 위해 API 사용량을 모니터링하고 청구 가능한 모든 API 요청의 일일 한도를 설정할 수 있습니다.

Google Maps Platform 제품은 표준 Google Maps Platform 서비스 약관에 따라 배포해야 합니다.

사용 비용은 어떻게 계산되나요?

Google Maps Platform 제품의 가격에 대한 개요는 가격표를 참고하세요.

Google Maps Platform API의 요금 청구 방식에 대해 자세히 알아보려면 지도, 경로, 장소, 환경의 결제 방식 이해하기를 참고하세요.

Google Maps Platform에서 지도 로드는 어떻게 계산되나요?

다음과 같은 경우 단일 지도 로드에 대해 요금이 청구됩니다.

페이지 또는 애플리케이션에서 Maps JavaScript API를 사용하여 지도를 표시
애플리케이션에서 Maps Static API에 단일 지도 이미지를 요청

스트리트 뷰 파노라마는 지도 로드와 별도로 요금이 부과됩니다.

정적 스트리트 뷰 파노라마는 정적(대화형이 아닌) 스트리트 뷰 파노라마를 삽입하기 위한 각 Street View Static API 요청에 대해 요금이 청구됩니다.
동적 스트리트 뷰 파노라마는 Maps JavaScript API, Android용 Maps SDK, iOS용 Maps SDK 애플리케이션에서 파노라마 객체를 인스턴스화할 때마다 요금이 청구됩니다.

웹페이지 또는 애플리케이션에서 지도, 정적 지도 이미지 또는 스트리트 뷰 파노라마를 로드한 후 이 항목과 사용자 지도 상호작용(예: 화면 이동, 확대/축소, 지도 레이어 전환)에 따라 추가 지도 로드가 생성되지 않으며 사용량 한도에 영향을 미치지 않습니다.

마커를 추가해도 추가 지도 로드가 생성되지 않지만 핀 위치가 파악된 방식(예: 'google.maps.Map()` 클래스 로드 또는 새로고침)에 대해 요금이 부과될 수 있습니다.

사용량을 모니터링하려면 어떻게 해야 하나요?

Google Cloud 콘솔에서 개별 API의 사용량을 모니터링할 수 있습니다.

검토할 API가 포함된 프로젝트를 선택합니다.
대시보드의 API 목록에서 API의 이름을 클릭합니다.
페이지 상단에서 측정항목 또는 할당량을 클릭합니다.

전체 프로젝트의 트래픽 보고서와 결제 정보를 보려면 다음 단계를 따르세요.

아직 설정하지 않은 경우 결제를 설정합니다.
Cloud 콘솔 결제 페이지로 이동합니다.
프로젝트를 선택합니다.
왼쪽 사이드바에서 보고서를 클릭합니다. 오른쪽 사이드바의 필터를 사용하여 결제 계정에서 보고서를 확인합니다.

자세한 내용은 Google Maps Platform 보고 및 API 사용량 모니터링과 API 사용량 한도 설정을 참고하세요.

요청 비율(QPM) 한도를 초과하면 어떻게 되나요?

주어진 QPM 한도를 초과하는 경우 Google Maps Platform 제품에서 API가 오류 메시지를 반환합니다. 한도를 반복적으로 초과하면 일시적으로 API에 액세스하지 못할 수도 있습니다.

요청 QPM 한도를 초과하는 경우 또는 서비스를 남용하지 않으면 요청에서 특정 오류 메시지를 반환합니다. 계속 한도를 초과하면 Google Maps Platform에 액세스하지 못할 수도 있습니다.

참고: Directions, Distance Matrix, Elevation, Geocoding 등 4개의 웹 서비스는 Maps JavaScript API에서 동등한 클라이언트 측 서비스를 사용할 수 있습니다.

사용량 한도 초과됨

사용량 한도를 초과하면 OVER_QUERY_LIMIT 상태 코드가 응답으로 제공됩니다.

이 메시지는 웹 서비스가 정상적인 응답을 더 이상 제공하지 않고 추가 사용이 다시 허용될 때까지 상태 코드 OVER_QUERY_LIMIT만 반환하도록 전환되었음을 의미합니다. 애플리케이션이 분당 너무 많은 요청을 전송하여 오류가 수신된 경우 몇 초 내에 이러한 일이 발생할 수 있습니다.

정기적으로 QPM 사용량 한도를 초과하는 경우 Google Maps Platform 제품을 더 효율적으로 사용하도록 애플리케이션을 최적화하여 사용량을 줄여보거나 할당량 증가를 요청하세요. 자세한 내용은 최적화 가이드를 참고하세요.

사이트에 트래픽이 많습니다. Google Maps Platform 제품을 사용할 수 있나요?

예. 하지만 애플리케이션에서 사용하는 모든 Google Maps Platform의 사용량 한도를 숙지하는 것이 좋습니다.

내 웹사이트 또는 애플리케이션의 사용자가 갑자기 많아지면 내 지도가 작동을 멈추나요?

결제 계정을 만든 후에 200달러의 무료 월간 사용량 한도를 초과했지만 결제 계정에 유효한 결제 수단(신용카드, 은행 송금 등)이 없는 경우 유효한 결제 수단을 추가할 때까지 API 작동이 중단됩니다.

사용량은 어떻게 계산되고 요금이 청구되나요?

사용량은 매일 하루가 끝날 때 계산되며 가격표에 표시된 대로 가격이 매겨집니다. 매월 말에 총 사용량을 기준으로 결제 계정과 연결된 결제 수단에 요금이 청구됩니다. 자세한 내용은 Google Maps Platform 결제를 참고하세요.

Google Maps Platform을 사용하는 데 비용이 얼마나 드나요?

API당 비용에 대한 개요는 가격표를 참고하세요. 애플리케이션에서 최대 200달러의 요청 또는 지도 로드를 생성하는 경우 요금을 청구하지 않습니다. 사용량이 200달러 월간 크레딧을 초과하면 결제 계정에 요금이 청구됩니다. 자세한 내용은 Google Maps Platform 결제 이해 가이드를 참고하세요.

다른 통화로도 가격 정보가 제공되나요?

콘솔에서 추가 통화를 사용할 수 있습니다. 다른 통화를 선택하면 가격표에 표시된 미국 달러를 환산한 금액으로 요금이 조정됩니다.

결제를 설정했습니다. 청구서를 보려면 어떻게 해야 하나요?

Google은 매월 초에 이전 달의 활동에 대해 지정된 결제 수단을 사용하여 요금을 청구합니다. 청구서에 대한 자세한 내용은 Google Maps Platform 결제 이해 가이드를 참고하세요.

추가 리소스

사용량이 예기치 않게 증가하여 과다한 금액이 청구되지 않도록 하려면 어떻게 해야 하나요?

Google Maps Platform에서는 일일 요청 한도를 설정하고 일일 최대 청구 가능 한도를 설정하는 방법을 제공합니다. 일일 최대 사용량 한도를 설정하여 예기치 않은 사용량 증가를 방지할 수 있습니다. 또한 예산 알림을 설정하면 결제 계정의 청구액이 설정한 기준액에 도달한 경우 이메일 알림을 받을 수 있습니다.

일일 최대 청구 가능 한도 설정:

과다한 금액이 청구되지 않도록 일일 사용량 한도를 설정하여 예기치 않은 사용량 증가를 방지할 수 있습니다. 다음 단계를 완료하여 Cloud 콘솔에서 이 한도를 변경할 수 있습니다.

API 및 서비스 대시보드로 이동합니다.
메시지가 표시되면 프로젝트를 선택합니다.
목록에서 API를 선택한 다음 할당량 탭을 클릭합니다.
'일일 요청 수' 할당량 옆에 있는 수정 아이콘을 클릭합니다.

또는 IAM 및 관리자 할당량 대시보드를 사용하여 여러 API에 대한 여러 가지 할당량을 수정할 수 있습니다.

예산 알림 설정 및 관리:

결제 계정의 청구액이 설정한 기준액에 도달한 경우 결제 관리자에게 이메일 알림을 보내려면 예산 알림을 설정하세요. 결제 계정의 예상 청구액이 기준액의 50%, 90%, 100%를 초과할 때 결제 관리자에게 이메일 알림이 전송됩니다.

내 프로젝트가 'Google Maps Platform 전환 계정'에 연결되어 있다는 메시지를 받았지만 해당 계정에 대한 액세스 권한이 없습니다. 어떻게 해야 하나요?

'Google Maps Platform 전환 계정'은 특정 고객이 사용한 만큼만 지불하는 새 요금제로 전환하는 데 도움을 주기 위해 만들어졌습니다. Google은 이 전환 계정을 통해 고객에게 일회성 크레딧을 제공하며 고객은 이를 통해 최대 200달러 한도에 도달할 때까지 Google Maps Platform을 무료로 계속 사용할 수 있습니다. 이 한도를 초과하면 결제 계정이 잠기고 서비스에 액세스할 수 없게 됩니다. 서비스 중단을 방지하려면 자체 결제 계정을 설정하고 월 200달러의 무료 크레딧을 사용하여 서비스를 계속 이용하시기 바랍니다. 프로젝트의 결제 계정을 변경하려면 다음 단계를 따르세요.

새 결제 계정을 만듭니다. 이미 결제 계정이 있으면 이 단계를 건너뛰세요.
결제 계정을 프로젝트와 연결합니다.

할당량 한도가 일일 요청 1회로 설정된 이유가 무엇인가요? 이 한도를 늘리려면 어떻게 해야 하나요?

결제 계정을 만들어 프로젝트에 연결하지 않은 경우 Maps Platform API의 일일 요청 횟수가 1회로 제한됩니다. 결제 계정을 만들고 연결하면 할당량을 늘릴 수 있습니다. 방법은 Google Maps Platform 시작하기를 참고하세요.

결제 계정을 만들고 연결하면 일일 할당량 한도가 삭제됩니다. Cloud 콘솔에서 한도를 설정하여 예기치 않은 지출을 방지할 수 있습니다.

결제 위반 알림을 받았습니다. 이 문제를 해결하려면 어떻게 해야 하나요?

해당 알림은 귀하의 계정에서 여러 개의 결제 계정을 사용하고 있다는 사실을 Google에서 확인한 경우 받게 됩니다. 이는 Google Maps Platform 서비스 약관의 3.2.4 조항을 위반하는 행위입니다. 이 약관에 따라 여러 개의 결제 계정을 만드는 행위는 금지됩니다. 자세한 내용은 결제 계정 위반 FAQ를 참고하세요.

Google Maps Platform 사용하기

여러 지도 제품에 어떤 키나 사용자 인증 정보를 사용해야 하나요?

Google Maps Platform 제품을 사용할 때마다 API 키를 포함하여 요청의 유효성을 검사해야 합니다. Google Maps Platform은 Android, iOS, 웹 앱에 사용할 수 있고 HTTP 웹 서비스를 통해 사용할 수 있습니다.

API 키:

API 키는 Cloud 콘솔을 사용하여 생성되는 고유 식별자입니다.
&key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo 키를 사용한 API 로드의 예

디지털 서명:

디지털 서명은 Google에서 제공한 URL 서명 비밀번호를 사용하여 생성됩니다. 디지털 서명은 Maps Static API 및 Street View Static API와 함께 사용됩니다.

제한:

API 키 제한은 선택사항이지만 보안을 강화하기 위해 모든 API 키를 제한하는 것이 좋습니다. 자세한 내용은 API 보안 권장사항을 참고하세요.
API 키에 애플리케이션 제한을 추가할 수 있습니다. 제한된 키는 해당 유형의 제한을 지원하는 플랫폼에서만 작동합니다. 네 가지 유형의 애플리케이션 제한을 사용할 수 있습니다. 동일한 제한 유형을 적용하는 API에서는 동일한 제한된 키를 사용할 수 있습니다.
- IP 주소(개별 서버) - 웹 서비스 API와 함께 사용
- HTTP 리퍼러(웹사이트) - 웹 API와 함께 사용
- Android 앱 제한(패키지 이름 및 디지털 지문 사용) - Android용 Maps SDK와 함께 사용
- iOS 앱 제한(iOS 번들 식별자 사용) - iOS용 Maps SDK와 함께 사용
API 키에 API 제한을 추가할 수도 있습니다. 자세한 내용은 API 키 가져오기, 추가하기, 제한하기를 참고하세요.

아래 표에는 각 Google Maps Platform API/SDK의 키/사용자 인증 정보 및 애플리케이션 제한이 나와 있습니다.

API/SDK	사용자 인증 정보 및 애플리케이션 제한
Android용 Maps SDK	Android 제한이 있는 API 키¹
Android용 Places SDK	Android 제한이 있는 API 키¹
Android용 Navigation SDK	Android 제한이 있는 API 키¹
iOS용 Maps SDK	iOS 제한이 있는 API 키¹
iOS용 Places SDK	iOS 제한이 있는 API 키¹
iOS용 Navigation SDK	iOS 제한이 있는 API 키¹
Maps JavaScript API	HTTP 리퍼러 제한이 있는 API 키¹
Map Tiles API	IP 주소 제한이 있는 API 키¹
Maps Datasets API	OAuth 토큰
Aerial View API	IP 주소 제한이 있는 API 키¹
Maps Static API	HTTP 리퍼러 제한¹ 및 디지털 서명²이 있는 API 키
Street View Static API	HTTP 리퍼러 제한¹ 및 디지털 서명²이 있는 API 키
Maps Embed API	HTTP 리퍼러 제한이 있는 API 키¹
Address Validation API	IP 주소 제한이 있는 API 키¹
Directions API	IP 주소 제한이 있는 API 키¹
Distance Matrix API	IP 주소 제한이 있는 API 키¹
Elevation API	IP 주소 제한이 있는 API 키¹
Geocoding API	IP 주소 제한이 있는 API 키¹
Geolocation API	IP 주소 제한이 있는 API 키¹
Places API	IP 주소 제한이 있는 API 키¹
Roads API	IP 주소 제한이 있는 API 키¹
Routes API	IP 주소 제한이 있는 API 키¹
Time Zone API	IP 주소 제한이 있는 API 키¹
Air Quality API	IP 주소 제한이 있는 API 키¹
Pollen API	IP 주소 제한이 있는 API 키¹
Solar API	IP 주소 제한이 있는 API 키¹

¹ API 키 제한은 선택사항이지만 보안을 강화하기 위해 모든 API 키를 제한하는 것이 좋습니다.

² 사용량에 따라 Maps Static API 및 Street View Static API에 디지털 서명이 필요할 수도 있습니다. 사용량에 관계없이 API 키와 디지털 서명을 모두 사용하여 요청을 인증하는 것이 좋습니다.

키 제한 유형을 HTTP 리퍼러에서 IP 주소 제한으로 전환하려면 어떻게 해야 하나요?

중요: 웹 서비스 API를 리퍼러 제한이 있는 API 키와 함께 사용하면 요청이 실패하고 '이 API 키와 사용하는 경우 API 키에 리퍼러 제한을 추가하면 안 됩니다.'라는 오류 메시지가 표시됩니다. 대신 IP 주소 제한이 있는 API 키를 사용해야 합니다.

API 키 제한 유형을 HTTP 리퍼러에서 IP 주소로 전환하기 전에 API 키를 사용하는 모든 API가 IP 제한 유형을 지원해야 합니다. 동일한 제한 유형의 API에서는 동일한 제한된 키를 사용할 수 있습니다. 두 개 이상의 제한을 적용해야 하는 경우 필요한 제한과 함께 별도의 키를 추가하세요. 새 API 키를 추가하는 방법을 알아보세요.

Google Maps Platform 제품과 연결된 API 키 제한에 대해 자세히 알아보세요.

HTTP 리퍼러 제한이 있는 API 키를 IP 주소 제한으로 전환하려면 다음 단계를 따르세요.

Cloud 콘솔의 사용자 인증 정보 페이지로 이동합니다.
수정할 API 키가 포함된 프로젝트를 선택합니다.
사용자 인증 정보 페이지의 API 키 목록에서 API 키의 이름을 선택하여 키의 세부정보를 수정합니다.
페이지의 키 제한 섹션에서 'IP 주소(웹 서버, 크론 작업 등)'를 선택하고 적절한 서버 IP 주소를 삽입한 다음 '저장'을 클릭합니다.

새 API 키를 가져오려면 어떻게 해야 하나요?

Google Maps Platform 시작하기를 참고하세요.

각 Google Maps Platform 버전에 도입된 변경사항을 확인하려면 어떻게 해야 하나요?

대부분 지도 API의 버전 변경사항은 다음 링크에서 확인할 수 있습니다.

또한 Google Maps Platform Issue Tracker를 사용하여 특정 버그가 발생하고 수정된 Google Maps Platform 버전을 확인할 수 있습니다.

https://issuetracker.google.com/bookmark-groups/76561

페이지가 로드된 후에 API를 페이지에 비동기식으로 로드하려면 어떻게 해야 하나요?

API를 로드할 때 콜백 매개변수를 지정하면 됩니다. 자세한 내용과 샘플 코드는 Maps JavaScript API 문서의 시작하기 장을 참고하세요.

영어가 아닌 언어로 Google Maps Platform 제품을 표시하려면 어떻게 해야 하나요?

기본적으로 API는 사용자 위치나 브라우저 설정을 기반으로 가장 적절한 언어를 로드하려고 시도합니다. 일부 API에서는 요청을 할 때 명시적으로 언어를 설정할 수 있습니다. 언어를 설정하는 방법에 대한 자세한 내용은 각 API의 문서를 참고하세요.

지원되는 언어:

Google에서는 지원되는 언어를 자주 업데이트합니다. 이 목록은 모든 언어가 포함되지 않을 수도 있으며 변경될 수 있습니다.

언어 코드	언어	언어 코드	언어
af	아프리칸스어	ja	일본어
sq	알바니아어	kn	칸나다어
am	암하라어	kk	카자흐어
ar	아랍어	km	크메르어
hy	아르메니아어	ko	한국어
az	아제르바이잔어	ky	키르기즈어
eu	바스크어	lo	라오어
be	벨라루스어	lv	라트비아어
bn	벵골어	lt	리투아니아어
bs	보스니아어	mk	마케도니아어
bg	불가리아어	ms	말레이어
my	버마어	ml	말라얄람어
ca	카탈로니아어	mr	마라타어
zh	중국어	mn	몽골어
zh-CN	중국어(간체)	ne	네팔어
zh-HK	중국어(홍콩)	no	노르웨이어
zh-TW	중국어(번체)	pl	폴란드어
hr	크로아티아어	pt	포르투갈어
cs	체코어	pt-BR	포르투갈어(브라질)
da	덴마크어	pt-PT	포르투갈어(포르투갈)
nl	네덜란드어	pa	펀자브어
en	영어	ro	루마니아어
en-AU	영어(오스트레일리아)	ru	러시아어
en-GB	영어(영국)	sr	세르비아어
et	에스토니아어	si	신할라어
fa	페르시아어	sk	슬로바키아어
fi	핀란드어	sl	슬로베니아어
fil	필리핀어	es	스페인어
fr	프랑스어	es-419	스페인어(라틴 아메리카)
fr-CA	프랑스어(캐나다)	sw	스와힐리어
gl	갈리시아어	sv	스웨덴어
ka	그루지아어	ta	타밀어
de	독일어	te	텔루구어
el	그리스어	th	태국어
gu	구자라트어	tr	터키어
iw	히브리어	uk	우크라이나어
hi	힌디어	ur	우르두어
hu	헝가리어	uz	우즈베크어
is	아이슬란드어	vi	베트남어
id	인도네시아어	zu	줄루어
it	이탈리아

이 샘플 애플리케이션에서 지도가 위에 나열된 언어 중 하나로 어떻게 표시되는지 확인할 수 있습니다.

SSL(HTTPS)을 통해 Google Maps Platform에 액세스할 수 있나요?

보안(HTTPS) 연결을 통해 Maps JavaScript API, Maps Static API, 웹 서비스 API에 액세스할 수 있습니다. SSL을 통해 API에 액세스하는 방법은 해당 API의 문서를 참고하세요.

Maps Static API는 HTTPS를 사용하는 맞춤 아이콘 URL을 지원하지 않습니다. 기본 아이콘이 표시됩니다.

Google Maps Platform의 버그를 신고하거나 새로운 기능을 요청하려면 어떻게 해야 하나요?

버그가 의심될 경우에는 먼저 관련 포럼에 올려주시기 바랍니다. 이렇게 하면 다른 개발자가 버그가 맞는지 확인하고 코드의 잠재적인 문제를 걸러낼 수 있습니다.

기능을 요청하려는 경우에도 먼저 관련 포럼에 질문을 올려서 내 요구사항에 맞는 해결책이 있는지 확인하세요.

새로운 버그를 발견했거나 Google Maps Platform 제품의 기존 기능으로 요구사항을 충족할 수 없다면 Google Maps Platform Issue Tracker를 사용하여 버그를 신고하거나 기능 요청을 제출하세요.

Issue Tracker에 버그나 기능 요청을 추가하기 전에 관련 버그나 기능이 이미 추가되어 있는지 확인하세요. 이미 추가되어 있는 경우에는 문제에 별표표시하여 관심 문제로 등록하고 업데이트 알림을 받을 수 있습니다.

Google Maps Platform API에서 사이트 쿠키를 어떻게 사용하나요?

Android용 Maps SDK와 iOS용 Maps SDK에서는 Google의 개인정보처리방침에 따라 쿠키를 사용합니다(예: 일일 및 7일간의 활성 사용자 계산 및 서비스 악용 방지). 이러한 쿠키는 로그인된 어느 Google 계정과도 연결되지 않으며, API 호출에서 수집한 나머지 정보로 기록되지 않습니다.

질문에 대한 답변을 찾을 수 없습니다. 어디에 문의해야 하나요?

Google의 개발자 관계팀은 프로그래머를 위한 질의응답 사이트인 Stack Overflow에 참여하고 있습니다. 이 사이트는 Google 지도 애플리케이션의 개발 및 유지 관리에 대한 기술적인 질문을 올리는 데 적합한 사이트입니다. Stack Overflow에 질문을 올리는 방법은 지원 페이지를 참고하세요.

도움 요청 시 최상의 결과를 얻으려면 다음 사항에 유의하세요.

현재 진행 중인 토론을 검색합니다. 다른 사람이 유사한 문제를 경험하고 해결책을 찾았을 수도 있습니다.
가능한 경우 사이트 링크를 제공합니다. 코드를 온라인으로 쉽게 볼 수 없는 경우에만 코드 스니펫을 게시하세요.
브라우저 버전, 오류, 기타 문제 해결에 도움이 될 만한 모든 정보를 제공합니다.

오류 및 문제 해결

이 오류는 무엇을 의미하나요?

Google 지도 API를 로드하거나 실행하는 동안 오류가 발생하면 다음 링크를 클릭하여 오류 코드의 설명을 찾아보세요.

지도가 평소보다 어둡게 표시됩니다. 어떤 상황인가요?

특정 상황에서는 '개발 전용'이라는 워터마크가 표시된 어두운 지도 또는 '음화' 스트리트 뷰 이미지가 표시될 수도 있습니다. 이 동작은 일반적으로 API 키 또는 청구 관련 문제를 나타냅니다. Google Maps Platform 제품을 사용하려면 결제 계정이 있어야 하고 모든 요청에 유효한 API 키가 포함되어야 합니다. 다음 단계에 따라 이 문제를 해결할 수 있습니다.

API 키를 사용하고 있나요?

잘 모르겠습니다. API 키를 사용 중인지 어떻게 확인할 수 있나요?

API 키는 Maps JavaScript API를 로드하는 데 사용되는 URL의 key 매개변수로 전달됩니다. 다음 방법으로 API 키를 사용하고 있는지 확인할 수 있습니다.

Google Maps Platform API Checker Chrome 확장 프로그램을 사용합니다. 이 프로그램을 사용하면 웹사이트에서 Google의 라이선스가 부여된 지도 API를 제대로 구현하고 있는지 확인할 수 있습니다.
라이브러리 또는 플러그인을 사용하여 Maps JavaScript API를 로드하는 경우 해당 라이브러리의 설정을 확인하고 API 키 옵션을 찾아보세요.
브라우저에서 오류를 확인합니다. 다음 메시지가 표시되면 API 키를 올바르게 사용하고 있지 않은 것입니다.

Google Maps JavaScript API 경고: NoApiKeys
Google Maps JavaScript API 오류: MissingKeyMapError

웹 개발자의 경우:

애플리케이션의 소스 코드에 액세스할 수 있는 경우 Maps JavaScript API를 로드하는 데 사용되는 <script> 태그를 찾아보세요. Maps JavaScript API를 로드할 때 아래 코드에서 YOUR_API_KEY를 API 키로 대체합니다.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
브라우저에서 웹사이트가 생성한 네트워크 트래픽을 확인합니다. Chrome에서는 DevTools 네트워크 탭을 사용하여 네트워크 트래픽을 확인할 수 있습니다. 여기에 웹사이트에서 요청한 네트워크 요청이 표시됩니다. Maps JavaScript API를 사용하여 한 요청은 maps/api/js 경로 아래 표시됩니다. 여기에서는 요청이 key 매개변수를 사용하는지 확인할 수 있습니다. 네트워크 탭을 볼 때 maps/api/js를 기준으로 네트워크 트래픽을 필터링하면 도움이 될 수도 있습니다.

아니요. API 키를 사용하고 있지 않습니다.

API 키를 가져오려면 아래 버튼을 클릭하세요. 설정 단계가 표시되지 않으면 Google Maps Platform 시작하기의 전체 안내를 따르세요.
시작하기

예. API 키를 사용하고 있습니다.

좋습니다. 계속하여 결제 계정이 프로젝트에 연결되어 있는지 확인하세요.

결제 계정이 프로젝트에 연결되어 있나요?

잘 모르겠습니다. 결제 계정이 프로젝트에 연결되어 있는지 확인하려면 어떻게 해야 하나요?

Google Cloud 콘솔의 결제 페이지로 이동하여 API 키가 생성된 프로젝트를 선택합니다. 키가 프로젝트와 연결되어 있는지 확인하려면 다음 단계를 따르세요.

Google Maps Platform > 사용자 인증 정보 아래 왼쪽 사이드바에서 액세스할 수 있는 사용자 인증 정보 섹션으로 이동합니다.
현재 웹사이트에서 사용하는 API 키가 등록되어 있는지 확인합니다. 그렇지 않은 경우 다른 프로젝트로 전환하여 사용자 인증 정보를 확인합니다.
API 키의 프로젝트를 찾을 수 없으면 더 이상 이 프로젝트에 액세스하지 못할 수도 있습니다. 조직의 다른 사용자에게 도움을 요청하세요. 원래 프로젝트를 찾을 수 없으면 다음 단계를 따르세요.
1. 새 프로젝트를 만듭니다. 프로젝트 목록에서 새 프로젝트를 선택하거나 Resource Manager 페이지를 통해 프로젝트 만들기를 선택하면 됩니다.
2. 새 API 키를 만듭니다. 새 API 키는 사용자 인증 정보 페이지에서 만들 수 있습니다. 이 페이지로 이동한 후 사용자 인증 정보 만들기를 클릭한 다음 API 키를 선택합니다.

Cloud 콘솔에서 프로젝트를 찾은 후 왼쪽 사이드 메뉴의 결제 섹션으로 이동하여 결제 계정이 연결되어 있는지 확인하세요.

아니요. 결제 계정이 프로젝트에 연결되어 있지 않습니다.

Cloud 콘솔에서 결제 사용 설정 페이지로 이동하여 프로젝트에 결제 계정을 추가합니다. 자세한 내용은 Google Maps Platform 시작하기를 참고하세요.

예. 결제 계정이 프로젝트에 연결되어 있습니다.

좋습니다. 제공된 결제 수단이 유효한지 확인해 보세요.

제공된 결제 수단이 더 이상 유효하지 않은가요(예: 신용카드가 만료됨)?

Cloud 콘솔에서 결제 수단을 추가, 삭제 또는 업데이트할 수 있습니다.

API에 직접 적용한 일일 한도를 초과했나요?

예기치 않은 사용량 증가를 방지하기 위해 API에 일일 한도를 설정한 경우 일일 한도를 늘려 이 문제를 해결할 수 있습니다.

Cloud 콘솔의 API 및 서비스 대시보드로 이동하여 일일 한도를 확인할 수 있습니다. 이 대시보드로 이동한 후 다음 단계를 따르세요.

메시지가 표시되면 프로젝트를 선택합니다.
목록에서 API를 선택한 다음 할당량 탭을 클릭합니다.

API 키에 IP 주소 제한이 있나요?

IP 주소 제한이 있는 API 키는 서버 측에서 사용할 웹 서비스(예: Geocoding API 및 기타 Web Service API)와 함께만 사용할 수 있습니다. 이러한 웹 서비스 대부분에는 Maps JavaScript API 내에 동일한 서비스가 있습니다(예: 지오코딩 서비스 참고). Maps JavaScript API 클라이언트 측 서비스를 사용하려면 HTTP 리퍼러 제한으로 보호할 수 있는 별도의 API 키를 만들어야 합니다 (API 키 가져오기, 추가하기, 제한하기 참고).

OVER_DAILY_LIMIT 또는 OVER_QUERY_LIMIT 오류 코드를 해결하려면 어떻게 해야 하나요?

다음과 같은 이유로 이 오류 코드가 반환될 수 있습니다.

요청에 API 키가 없습니다.
제공된 API 키가 잘못되었습니다.
프로젝트에 결제 계정이 연결되어 있지 않습니다.
자체 적용되는 사용량 한도를 초과했습니다.
제공된 결제 수단이 더 이상 유효하지 않습니다(예: 신용카드가 만료됨).
지정된 API의 할당량 한도를 초과했습니다.

Google Maps Platform 제품을 사용하려면 결제 계정이 있어야 하고 모든 요청에 유효한 API 키가 포함되어야 합니다. 이 문제를 해결하려면 다음 단계를 따르세요.

결제 계정을 설정합니다.
새 API 키를 가져옵니다.
사용량 한도를 조정하여 일일 한도를 늘립니다(해당하는 경우).

kGMSPlacesRateLimitExceeded 또는 9005 PLACES_API_RATE_LIMIT_EXCEEDED 오류 코드를 해결하려면 어떻게 해야 하나요?

kGMSPlacesRateLimitExceeded 또는 9005 PLACES_API_RATE_LIMIT_EXCEEDED 오류가 표시되면 Android용 Places SDK 또는 iOS용 Places SDK의 지원 중단된 버전을 사용 중일 수도 있습니다. https://goo.gle/places-sdk-deprecation에서 자세히 알아보고 새 SDK를 찾아보세요.

'이 IP, 사이트 또는 모바일 애플리케이션은 이 API 키를 사용할 권한이 없습니다.' 오류를 해결하려면 어떻게 해야 하나요?

다음과 같이 다양한 상황에서 이 오류가 발생할 수 있습니다.

API 키에 IP 주소(서버) 제한을 사용 설정했으며 승인되지 않은 IP 주소에서 요청을 시도하고 있습니다.
API 키에 HTTP 리퍼러(웹사이트) 제한을 사용 설정했으며 승인되지 않은 리퍼러에서 요청을 시도하고 있습니다.
패키지 이름과 디지털 지문을 설정하여 Android 앱으로 사용을 제한했으며 승인되지 않은 Android 앱에서 요청을 시도하고 있습니다.
번들 식별자를 지정하여 iOS 앱의 요청을 제한했으며 인식할 수 없는 iOS 앱에서 요청을 전송하려고 시도하고 있습니다.
HTTP 리퍼러 제한이 있는 API 키와 함께 웹 서비스 API를 사용하는 경우 이 오류가 발생할 수 있었습니다. 이러한 API에 대한 요청은 IP 주소 제한이 있는 API 키로 식별되어야 합니다. 키 제한 유형을 HTTP 리퍼러 제한에서 IP 주소 제한으로 전환하세요. API 키 제한에 대한 자세한 내용은 API 키 권장사항을 참고하세요.

API 키 사용자 인증 정보 보기 및 수정

API 키를 확인하고 제한을 관리하려면 다음 작업을 실행하세요.

Cloud 콘솔의 사용자 인증 정보 페이지로 이동합니다.
검토할 API 키가 포함된 프로젝트를 선택합니다.
키에 설정된 제한 등 사용자 인증 정보 세부정보를 보려면 API 키 목록에서 키의 이름을 클릭하세요.
키에 설정된 제한을 포함하여 선택한 API 키의 전체 사용자 인증 정보가 표시됩니다. 이제 필요에 따라 제한을 변경하거나 삭제하거나 업데이트할 수 있습니다.

'리퍼러 제한이 있는 API 키는 이 API와 함께 사용할 수 없습니다.' 오류를 해결하려면 어떻게 해야 하나요?

HTTP 리퍼러로 제한된 API 키와 함께 웹 서비스 API를 사용하고 있습니다. 보안상의 이유로 웹 서비스 API는 IP 주소로 제한된 API 키를 사용해야 합니다. 키 제한 유형을 HTTP 리퍼러 제한에서 IP 주소 제한으로 전환하거나 키가 이미 Maps JavaScript API와 함께 사용되고 있으면 새 API 키를 만드세요.

Google Maps Platform 서비스

주소를 위도/경도 쌍으로 변환해야 합니다. Google Maps Platform을 사용하여 변환할 수 있나요?

예, 가능합니다. 이 과정을 '지오코딩'이라고 합니다. Maps JavaScript API에는 지오코딩 서비스를 실행하기 위한 클래스가 포함되어 있습니다. 클래스는 google.maps.Geocoder입니다.

또는 Google에서 JSON 및 XML 형식으로 응답할 수 있는 REST 인터페이스를 제공하는 Geocoding API도 제공합니다.

지오코딩은 어느 국가에서 사용할 수 있나요?

현재 Google Maps Platform 지오코더에서 지원하는 국가는 Google 지도 서비스 지역 데이터를 참고하세요.

지오코딩된 위치의 정확도는 국가에 따라 다를 수 있으므로 반환된 location_type 필드를 사용하여 애플리케이션의 용도에 맞는 위치가 있는지 확인하시기 바랍니다. 지오코딩 데이터의 사용 가능 여부는 데이터 제공업체와의 계약에 따라 변경될 수 있습니다.

Google Maps Platform 지오코더에서 Google 지도와 다른 위치를 제공하는 이유는 무엇인가요?

API 지오코더와 Google 지도 지오코더는 국가에 따라 서로 다른 데이터 세트를 사용하는 경우가 있습니다. API 지오코더는 가끔 새 데이터로 업데이트되므로 시간이 지남에 따라 결과가 변경되거나 개선될 수 있습니다.

성공적으로 처리되는 요청 수를 최대한으로 늘리려면 지오코더 쿼리의 형식을 어떻게 지정해야 하나요?

지오코더는 상세 주소를 지리적 좌표에 매핑하도록 설계되었습니다. 따라서 쿼리의 성공 가능성을 극대화하려면 다음 가이드라인에 따라 지오코더 요청의 형식을 지정하는 것이 좋습니다.

관련 국가의 우편 서비스에서 사용하는 형식에 따라 주소를 지정합니다.
관련 국가의 우편 서비스에서 정의된 주소 형식에 포함되지 않은 추가 주소 요소(예: 업체 이름, 호수, 층 번호, 방 번호)를 지정하지 않습니다. 지정할 경우 ZERO_RESULTS 응답이 생성될 수 있습니다.
여기 표시된 대로 Plus Code의 형식을 지정합니다. 더하기 기호는 %2B로 URL 이스케이프 처리되고 공백은 %20으로 URL 이스케이프 처리됩니다.
- 글로벌 코드는 4자리 지역 코드와 6자 이상의 로컬 코드입니다(849VCWC8+R9는 849VCWC8%2BR9입니다).
- 복합 코드는 명시적인 위치가 포함된 6자 이상의 로컬 코드입니다(CWC8+R9 Mountain View, CA, USA는 CWC8%2BR9%20Mountain%20View%20CA%20USA입니다).
가능하면 건물 이름보다 건물의 거리 번호를 사용합니다.
가능하면 교차로보다 주소를 나타내는 거리 번호를 사용합니다.
주변 명소와 같은 '힌트'를 제공하지 않습니다.

고속도로 번호를 사용하는 미국 주소의 형식을 지오코딩에 맞게 지정하려면 어떻게 해야 하나요?

Google Maps Platform 지오코더에서는 고속도로 번호를 사용하는 미국 주소를 다음과 같이 지정해야 합니다.

카운티 도로: "Co Road NNN", 여기서 NNN은 도로 번호입니다. 예: "Co Road 82"
주도: "State NNN", 여기서 State는 주의 전체 이름이고 NNN은 고속도로 번호입니다. 예: "California 82"
국도: "U.S. NNN", 여기서 NNN은 고속도로 번호입니다. 예: "U.S. 101"
주간 도로: "Interstate NNN", 여기서 NNN은 주간 도로의 번호입니다. 예: "Interstate 280"

API 지오코더 클래스와 HTTP 지오코딩 서비스는 각각 어느 경우에 사용하나요?

여러 지오코딩 전략의 장단점이 설명되어 있는 지오코딩 전략을 참고하세요.

Google Maps Platform으로 운전 경로를 제공하려면 어떻게 해야 하나요?

Routes API 및 Directions API의 Compute Routes 서비스를 사용하면 단일 구간 및 다구간 여정의 운전 경로를 제공할 수 있습니다. 경로 옵션은 이동 수단(운전), 단일 경로 또는 경로 세트, 제한사항(유료 도로 제외)을 사용하여 경로를 구성하는 데 도움이 됩니다. 서비스는 다음과 같은 형식으로 제공됩니다.

HTTP 요청/응답 인터페이스(모바일 및 기타 애플리케이션에서 사용됨)는 Android용 Maps SDK 및 기타 Google 지도 웹 서비스와 호환됩니다.
클라이언트 측 애플리케이션의 경우 JavaScript API를 사용하여 google.maps.DirectionsService 클래스를 통해 운전 경로를 제공할 수 있습니다. DirectionsRenderer 클래스를 사용하면 자동으로 오버레이와 경로 패널이 생성됩니다. 문서에 나와 있는 다른 예를 참고하세요.
서버 측 애플리케이션의 경우 Java, Python, go, Node.js 클라이언트 인터페이스가 동일한 기능을 제공합니다. 클라이언트 라이브러리에 대한 자세한 내용은 Directions API 클라이언트 라이브러리를 참고하세요.

운전 경로는 어느 국가에서 사용할 수 있나요?

현재 Google Maps Platform 제품의 운전 경로에서 지원하는 국가는 Google 지도 서비스 지역 데이터를 참고하세요. 운전 경로 데이터의 사용 가능 여부는 데이터 제공자와의 계약에 따라 변경될 수 있습니다.

대중교통 경로는 어느 국가에서 사용할 수 있나요?

Directions API 및 Distance Matrix API는 일본을 제외한 모든 Google 대중교통 파트너를 지원합니다.

Maps JavaScript API에서 어느 KML 및 GeoRSS 기능이 지원되나요?

Maps JavaScript API의 KmlLayer 클래스를 사용하면 개발자가 지도 위에 KML/KMZ 및 GeoRSS 파일을 오버레이할 수 있습니다. 문서와 예는 여기에서 확인할 수 있습니다.

Maps JavaScript API의 KmlLayer 클래스를 사용하여 표시할 수 있는 KML의 크기와 복잡도는 어느 정도로 제한되나요?

KmlLayer 클래스를 사용한 KML 표시의 최대 크기 및 복잡도는 여기에 설명되어 있습니다.

인트라넷 사이트에 호스팅되는 KML 파일을 지도에 렌더링하려면 어떻게 해야 하나요?

Maps JavaScript API에서 KML 오버레이를 생성하는 KmlLayer 클래스는 Google 호스팅 서비스를 사용하여 렌더링할 KML 파일을 가져오고 파싱합니다. 따라서 공개적으로 액세스 가능한 URL에서 호스팅되지 않거나 액세스하려면 인증이 필요한 KML 파일은 표시할 수 없습니다.

인트라넷 사이트에서 호스팅되는 KML 파일을 사용하는 애플리케이션을 개발하려면 서드 파티 JavaScript 라이브러리를 사용하여 클라이언트 측에서 KML 파일을 렌더링하는 것이 좋습니다. KML 파일은 브라우저에 의해 분석되므로 KmlLayer 클래스를 사용하는 것보다 성능이 낮을 수 있습니다.

Maps Static API에서는 마커 또는 경로 꼭짓점이 최대 몇 개까지 지원되나요?

Maps Static API에서 지원하는 마커 및 경로 꼭짓점의 수에는 제한이 없습니다. 맞춤 아이콘 사용 시 요청당 최대 5개의 고유 아이콘을 지정할 수 있지만 지도에서 각 아이콘을 여러 번 사용할 수 있습니다.

Maps Static API URL에는 최대 약 8,192자를 포함할 수 있는데 이에 따라 각 위도/경도 쌍을 지정할 때 사용된 소수 자릿수를 기반으로 지정할 수 있는 마커 및 경로 꼭짓점의 수가 제한됩니다. 사용된 소수 자릿수가 어스의 정확도와 어떤 관련이 있는지에 관한 정보는 소수 계수에 대한 Wikipedia 게시물을 참고하세요.

특정 국가에서 Google Maps Platform 제품에 액세스할 수 없는 이유는 무엇인가요?

지도 API는 금지된 지역에서 사용할 수 없습니다. 서비스 약관도 참고하세요.

Google 기본 지도의 문제를 신고하려면 어떻게 해야 하나요?

다음과 같이 지도 정보가 잘못되었거나 누락된 경우 Google 지도를 통해 의견을 보내주세요.

잘못된 주소 또는 마커 위치
잘못된 도로 이름
잘못된 일방통행 및 양방통행 도로 정보
잘못 그려진 도로
폐쇄된 도로
존재하지 않는 도로

장소 또는 비즈니스 정보를 수정하려면 수정을 제안하세요.

법적인 이유로 지도 콘텐츠를 삭제해야 하는 경우 법적 요청을 제출하세요.

중요하거나 긴급한 요청의 경우 수정되어야 하는 사항에 관한 구체적인 세부정보와 함께 지원 케이스를 제출하세요.

Maps JavaScript API와 함께 사용하는 서비스의 성능은 어떻게 모니터링되나요?

일부 클라이언트 측 기능은 SLO(서비스 수준 목표)를 계산할 목적으로 성공 또는 실패를 보고하도록 계측됩니다. 이 정보는 SLO 정보를 기록하는 호출을 통해 Google(maps.googleapis.com/maps_api_js_slo/log)에 전송됩니다. 이 정보에는 사용 중인 Maps JavaScript API의 성공 상태, 지연 시간, 버전/채널이 포함됩니다. 호출은 성능 향상을 위해 일괄 처리될 수 있습니다. 이러한 호출이 브라우저 수준에서 차단되지 않도록 하려면 콘텐츠 보안 정책에서 maps.googleapis.com을 허용해야 할 수도 있습니다. 예를 들어 HTTP 헤더가 있는 Content-Security-Policy: default-src 'self' maps.googleapis.com; 또는 HTML 메타 태그가 있는 <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;">입니다.

Maps JavaScript API

Maps JavaScript API가 로드된 후 얼마나 오래 작동하나요?: Maps JavaScript API를 로드하는 페이지를 5일마다 한 번 이상 새로고침해야 합니다.

iOS용 Google Maps SDK

kGMSPlacesRateLimitExceeded 오류를 해결하려면 어떻게 해야 하나요?

이 오류가 표시되면 iOS용 Places SDK의 지원 중단 버전을 사용 중일 수도 있습니다. iOS용 Places SDK 버전 2.7.0은 사용 중지되었으며 더 이상 사용할 수 없습니다. 가능한 한 빨리 최신 버전을 사용하도록 앱을 업데이트하세요. 자세한 내용은 이전 가이드를 참고하세요.

iOS 8.x 기기로 디버깅할 때 비정상 종료됩니다. 어떻게 해야 하나요?

iOS 8.x를 실행하는 기기로 디버깅할 때 문제가 발생하면 다음 단계에 따라 실행 중인 XCode 스키마에서 GPU 프레임 캡처를 사용 중지하세요.

XCode에서 Product(제품), Scheme(스키마), Manage Schemes(스키마 관리)를 선택합니다.
스키마를 선택하고 Edit(수정)...를 선택합니다.
GPU Frame Capture(GPU 프레임 캡처) 옵션을 Disabled(사용 중지됨)로 설정합니다. 일부 기기에는 이 옵션이 없을 수도 있습니다.

더 넓어진 둥근 형태의 화면이 Google 지도 iOS SDK에 어떤 영향을 미치나요?

iPhone X부터, iPhones의 화면은 모서리가 둥근 모양이고, 기기의 센서 하우징 상단에 홈이 있고, 화면 하단에 홈 화면에 액세스하기 위한 표시기가 표시됩니다. iOS 11.0 SDK부터, Apple에서는 Safe Area API를 추가하여 개발자가 새 화면 모양에 의해 잘리지 않는 안전 영역에 요소를 배치할 수 있도록 했습니다.

iOS용 Google Maps SDK에는 실내 선택 도구와 문제 신고 링크 등 다양한 시각적 요소와 컨트롤이 있습니다. 버전 2.4에서는 이러한 새로운 시각적 요소와 컨트롤이 새로운 화면 모양에 의해 잘릴 수 있었습니다. 가로 모드에서는 실내 층 선택 도구가 노치 또는 홈 버튼 표시기에 의해 잘릴 수도 있습니다.

iOS용 Google Maps SDK 버전 2.5에서는 이러한 레이아웃 문제가 자동으로 해결됩니다. 앱이 iPhone X 이상에서 사용되는 경우 GMSMapView 및 GMSPanoramaView의 패딩이 증가하여 시각적 요소가 잘리지 않습니다.

기본적으로 패딩이 항상 포함됩니다. iOS용 Google Maps SDK에서는 안전 영역 내에서 패딩이 삽입된다고 가정합니다. 모든 요소가 안전 영역 내에 배치된다는 가정에서 인터페이스를 설계하면 추가 작업 없이도 인터페이스가 작동합니다.

기본 조정을 통해 작동하지 않는 인터페이스를 설계한 경우를 위해 GMSMapView에 paddingAdjustmentBehavior라는 새로운 속성이 도입되었습니다. 이제 GMSMapView를 사용하여 '항상'(기본값), '자동', '안함'의 세 가지 조정 동작 중에서 선택할 수 있습니다.

GMSMapView가 '항상' 패딩 동작을 사용하도록 설정된 경우 항상 안전 영역 인셋을 패딩에 추가합니다. 이를 통해 모든 게재위치가 안전 영역의 가장자리에서 떨어져 있다는 가정에서 인터페이스를 설계할 수 있습니다. 이 설정이 기본 설정입니다.

GMSMapView가 '자동' 패딩 동작을 사용하도록 설정된 경우 항상 더 큰 패딩 또는 안전 영역 인셋을 선택합니다. 이렇게 하면 화면 가장자리에서 패딩을 추가할 수 있으며 모든 요소가 항상 안전 영역 내에 포함됩니다.

GMSMapView가 '안함' 패딩 동작을 사용하도록 설정된 경우 안전 영역 인셋이 절대 패딩에 추가되지 않습니다. 이 동작은 버전 2.5 이전의 동작이며 패딩에서 이미 안전 영역을 고려하거나 다른 동작이 인터페이스와 잘 호환되지 않는 경우 유용할 수도 있습니다. Google Maps Platform 서비스 약관에 명시된 대로 Google 로고 및 저작권 고지가 항상 표시되는지 확인하는 것은 사용자의 책임입니다.

반대로 GMSPanoramaView에는 선택적 패딩 속성이 없습니다. 즉 조정할 패딩이 없으며 GMSPanoramaView에서 항상 필요한 패딩을 적용하여 모든 시각적 요소가 안전 영역 내에 있도록 합니다.

Android용 Google Maps SDK

9005 PLACES_API_RATE_LIMIT_EXCEEDED 오류를 해결하려면 어떻게 해야 하나요?: 이 오류가 표시되면 Android용 Places SDK의 지원 중단 버전을 사용 중일 수도 있습니다. Android용 Places SDK의 Google Play 서비스 버전은 사용 중지되었으며 더 이상 사용할 수 없습니다. 가능한 한 빨리 최신 버전을 사용하도록 앱을 업데이트하세요. 자세한 내용은 이전 가이드를 참고하세요.

앱에 지도 대신 빈 회색 타일만 표시됩니다. 이 문제를 해결하려면 어떻게 해야 하나요?

지도 대신 빈 회색 타일이 표시되는 일반적인 이유는 인증 문제입니다. 아래 단계에 따라 adb logcat을 사용하여 문제를 해결할 수 있습니다.

adb가 설치되어 있는지 확인합니다. 설치되지 않았으면 여기에 제시된 가이드를 따르세요.
기기 또는 Android 에뮬레이터의 문제를 보여주는 앱을 설치합니다. Android Emulator를 사용하는 경우 에뮬레이터 설정에 Play 스토어가 포함되어 있는지 확인합니다.
Android 스튜디오 터미널에서 adb logcat -e "Google Maps Android API" 코드를 실행합니다. 로그 메시지가 'Google Maps Android API'와 일치하는 행만 출력됩니다. 원하는 경우 > logcat.txt를 추가하여 로그를 텍스트 파일로 출력할 수 있습니다.
기기에서 문제를 재현하고 다음과 같은 일반적인 오류가 있는지 확인합니다.

잘못되거나 의도되지 않은 API 키가 매니페스트에서 참조되고 있습니다.
프로젝트에서 결제가 사용 설정되지 않았습니다.
SDK가 프로젝트 API에서 사용 설정되지 않았습니다.
잘못된 SHA1 디지털 지문이 API 키 제한에 추가되었습니다.
Google Play 서비스 종속 항목이 build.gradle 파일에 포함되어 있지 않습니다.

URL 서명

JavaScript를 사용하여 URL에 서명할 수 있나요?

JavaScript를 사용하여 URL에 서명하면 URL 서명 비밀번호가 최종 사용자에게 노출될 수 있으므로 서명하지 않는 것이 좋습니다. 따라서 서명은 서버 측 구성요소에 의해서만 생성되어야 합니다.

지도 API 웹 서비스 요청에 대해 HTTP 403 금지됨 응답이 수신되는 이유가 무엇인가요?

HTTP 403 응답은 사용 권한 문제를 나타내며 이 요청에 대한 서명을 확인할 수 없기 때문에 발생할 수 있습니다. 다음과 같은 이유로 발생할 수 있습니다.

이 요청에 적합하지 않은 서명이 지정되었습니다.
요청은 Google Maps Platform 프리미엄 요금제 API 키를 지정하되 서명을 지정하지는 않으며, 호출되는 서비스에서는 API를 사용한 요청에 올바른 서명이 포함되어야 합니다.
서명이 지정되었지만 연결된 Google Maps Platform 프리미엄 요금제 API 키가 지정되지 않았습니다.