시작하기
- Google Maps API란 무엇인가요?
- 어떤 API가 필요한가요?
- Google Maps API에는 어떤 나라가 포함되나요?
- Google Maps API를 사용하지 않고 제 사이트에 Google 지도를 넣을 수 있나요?
- 모바일 기기에서 지도 애플리케이션을 제공하려면 어떻게 하나요?
- 어떤 웹 브라우저가 Google Maps JavaScript API를 지원하나요?
- 제 사이트에서 Google Maps API 사용을 시작하려면 어떻게 하나요?
- Google Maps API에 변경이 있는 경우 어떻게 알림을 받나요?
서비스 약관 이해
- Google Maps API의 서비스 약관이란 무엇인가요?
- 제 사이트가 Google Maps API의 서비스 약관을 충족하나요?
- 지도와 위성 이미지에 직접 액세스할 수 있나요?
- 상업용 웹사이트에서 Google Maps API를 사용할 수 있나요?
- 추적 애플리케이션에서 Google Maps API를 사용할 수 있나요?
- 웹용이 아닌 애플리케이션에서 Google Maps API를 사용할 수 있나요?
- 암호로 보호된 사이트에서 Google Maps API를 사용할 수 있나요?
- Google Maps API 애플리케이션의 스크린샷을 인쇄 자료 또는 오프라인 미디어에서 사용할 수 있나요?
- 제 콘텐츠가 Google 검색 결과에 포함되지 않도록 선택하려면 어떻게 하나요?
- JavaScript Maps API를 사용할 때 어떤 정보가 Google로 전송되나요?
- 제 웹사이트에 저장하여 서비스 중인 Google Static Maps API를 사용하여 지도 이미지를 생성할 수 있나요?
사용 제한 및 결제
- 어떤 Google Maps API에 사용 제한이 있나요?
- Google Maps API의 사용 제한이란 무엇인가요?
- 사용 할당량은 어떻게 계산되나요?
- Google Maps Web API에 사용 제한이 적용되는 상황에서 '지도 로드'는 어떻게 구성되나요?
- 제 사용 할당량을 어떻게 모니터링하나요?
- 사용 제한을 초과하면 어떻게 되나요?
- 제 사이트에 트래픽이 너무 많습니다. Maps API를 사용할 수 있나요?
- Google Maps API 프리미엄 플랜을 구매해야 하나요?
- 제 웹사이트나 애플리케이션이 갑자기 인기가 있어지면, 제 지도가 작동을 멈추나요?
- 초과 사용량은 어떻게 계산하고 결제하나요?
- Google Maps API를 사용하는 비용은 얼마나 되나요?
- 가격을 다른 통화로도 볼 수 있나요?
- 결제를 활성화했습니다. 제 청구서를 보려면 어떻게 하나요?
- 예상치 못한 사용량 증가로 인해 많은 금액의 청구서를 받지 않으려면 어떻게 하나요?
Google Maps API 사용
- 다른 지도 제품에는 어떤 키나 자격 증명을 사용해야 하나요?
- 키 유형을 브라우저 키에서 서버 키로 어떻게 전환하나요?
- 다음 오류를 어떻게 해결하나요? "이 IP, 사이트 또는 모바일 애플리케이션은 이 API 키를 사용할 권한이 없습니다."
- Google Maps API의 각 버전에 소개되는 변경사항을 어떻게 찾을 수 있나요?
- 페이지가 로드된 후 이 페이지에 API를 비동기식으로 로드하려면 어떻게 하나요?
- 영어 이외의 다른 언어로 Google Maps API를 표시하려면 어떻게 하나요?
- SSL(HTTPS)를 통해 Google Maps API에 액세스할 수 있나요?
- Google Maps API에서 버그를 신고하거나 새로운 기능을 요청하려면 어떻게 하나요?
- 이 오류는 무엇을 의미하나요?
- 다른 질문/문제가 있습니다. 누구에게 연락해야 하나요?
Google Maps API 서비스
- 주소를 위도/경도 쌍으로 변환해야 합니다. Google Maps API에서 변환할 수 있나요?
- 지오코딩을 사용할 수 있는 국가는 어디인가요?
- Google Maps API 지오코더가 Google 지도와 다른 위치를 제공하는 이유는 무엇인가요?
- 요청 성공 횟수를 극대화하려면, 지오코더 쿼리의 형식을 어떻게 지정해야 하나요?
- 지오코딩을 위해, 번호가 있는 고속도로에서 미국 주소를 어떤 형식으로 지정해야 하나요?
- 언제 API 지오코더 클래스를 사용하고 언제 HTTP 지오코딩 서비스를 사용해야 하나요?
- Google Maps API로 자동차 길찾기를 제공하려면 어떻게 하나요?
- 자동차 길찾기를 사용할 수 있는 국가는 어디인가요?
- 대중교통 길찾기를 사용할 수 있는 국가는 어디인가요?
- Google Maps Javascript API에서 지원되는 KML & GeoRSS의 기능은 무엇인가요?
- Google Maps JavaScript API의 KmlLayer 클래스를 사용하여 표시할 수 있는 KML의 크기 및 복잡성에 대한 제한은 무엇인가요?
- Google Static Maps API에서 지원되는 마커 또는 경로 교점의 최대 수는 몇 개인가요?
- 중국에서는 Google Maps API에 액세스할 수 없는 이유가 무엇인가요?
시작하기
- Google Maps API란 무엇인가요?
-
Google Maps API는 Google 지도를 웹 페이지에 포함할 수 있는 여러 가지 방법을 개발자에게 제공하며, 단순한 사용이나 광범위한 사용자 지정을 모두 허용합니다. 현재 다음과 같은 몇 가지 API가 제공됩니다.
필요에 따라 이러한 API를 하나만 사용하거나 조합하여 사용할 수 있습니다.
기업 또는 상업용 웹사이트를 운영하고 있는 경우에는, Google Maps API for Work도 관심을 가지실 수 있습니다.
- 어떤 API가 필요한가요?
-
본인의 기능적 요구사항에 맞는 올바른 API를 찾으려면, API 선택기를 둘러보세요.
- Google Maps API에는 어떤 나라가 포함되나요?
-
Google 지도 팀은 새로운 지도 데이터를 끊임없이 내놓고 있으며 전세계적인 커버리지를 늘려가고 있습니다. 최신 커버리지 정보에 대해서는 Google 지도 커버리지 데이터를 참조하세요. 페이지 상단의 필터 상자로 데이터를 필터링할 수 있습니다. 참고로, 데이터 공급자와의 라이선스 계약이 변경되면 커버리지 데이터가 변경될 수 있습니다.
참고 항목:
- Google Maps API를 사용하지 않고 제 사이트에 Google 지도를 넣을 수 있나요?
-
예. 이제 Google 지도는 프로그래밍이나 Google Maps API를 사용하지 않고도, 보고 있는 지도를 자신의 웹사이트나 블로그에 포함할 수 있는 기능을 제공합니다. 자세한 내용은 여기에서 찾을 수 있습니다.
- 모바일 기기에서 지도 애플리케이션을 제공하려면 어떻게 하나요?
-
Google Maps JavaScript API는 모바일 기기에 맞게 개발되었으며, 완벽한 JavaScript 구현의 웹 브라우저가 포함된 기기(예: Apple iPhone)와 데스크톱을 대상으로 하는 브라우저 애플리케이션에 적합합니다.
JavaScript API를 사용하기에 부적합한 기기를 대상으로 하는 애플리케이션의 경우, Google Static Maps API는 마커와 폴리라인이 포함된 GIF, JPG 및 PNG 형식의 지도 이미지를 제공합니다. 참고로, 브라우저 기반의 애플리케이션을 벗어나서 Google Static Maps API를 사용할 경우, 지도 이미지를 Google 지도에 링크해야 합니다.
지도를 Android 애플리케이션에 통합하려면, Android Maps 외부 라이브러리를 사용하세요.
지도를 네이티브 iOS 애플리케이션에 통합하려면, Google Maps SDK for iOS를 사용하세요.
- 제 사이트에서 Google Maps API 사용을 시작하려면 어떻게 하나요?
-
예시와 자세한 내용은 Maps Javascript API 문서를 참조하세요.
- Google Maps API에 변경이 있는 경우 제가 어떻게 알림을 받나요?
-
다양한 Google Geo 개발자 제품에 대한 뉴스 업데이트를 받으려면, Google Geo Developers Blog를 구독해야 합니다.
또한 각 API에는 알림 그룹이 있어서, 신규 릴리스 등 애플리케이션에 영향을 미치는 변경사항을 확인할 수 있습니다. 이들 그룹은 모두 Google Maps API 지원 페이지에 나열되어 있습니다.
서비스 약관 이해
- Google Maps API의 서비스 약관이란 무엇인가요?
-
Google Maps API의 서비스 약관은 다음 사이트에서 확인할 수 있습니다.
https://developers.google.com/maps/terms
Google Maps API for Work 고객인 경우, Google Maps API의 사용에 대해 기술된 약관의 계약 내용을 참조하세요.
- Google Maps API의 서비스 약관을 제 사이트가 충족하나요?
-
고객이 무료로 액세스가 가능한 모든 사이트에서 Maps API를 사용할 수 있습니다. 귀하의 사이트가 서비스 약관을 충족시키는 한, Google Maps API를 상업용 및 비영리 웹사이트에서 모두 사용할 수 있습니다.
그러나, 저희가 바라지 않는 Google Maps API의 용도가 몇 가지 있습니다(예: 도시에서 불법 약물의 구매 장소를 찾거나 기타 불법 행위를 위해 지도를 사용하는 경우). 저희는 또한 사람들의 개인정보를 존중하므로, 개인의 개인정보를 식별하는 데 Google Maps API를 사용해서는 안됩니다.
애플리케이션을 개발하여 출시하기 전에 애플리케이션이 서비스 약관을 준수하는지 여부를 본인 스스로 판단해야 합니다. Google 엔지니어는 기술 지원만을 제공하며 법률적 조언을 제공할 자격이 없습니다. Google은 언제든지 서비스 사용을 보류하거나 종료할 권리를 보유하므로, 서비스 약관을 자세히 읽어보세요.
기업 또는 상업용 웹사이트를 운영하고 있는 경우에는, Google Maps API for Work도 관심을 가지실 수 있습니다. 이 제품은 귀하의 요구사항에 더욱 적합하도록 서비스 약관을 수정했습니다.
- 지도와 위성 이미지에 직접 액세스할 수 있나요?
-
Google Maps API를 제외한 다른 메커니즘(예: 자체 매핑 API를 생성하거나 벌크 타일 다운로드 스크립트를 사용하는 경우)을 통해서는 지도 또는 위성 이미지에 액세스하지 못할 수 있습니다. Google Maps API를 벗어나서 액세스하는 경우에는 애플리케이션의 타일 액세스가 차단됩니다. 자세한 내용은 Google 지도 서비스 약관의 섹션 10.1.a를 참조하세요.
- 상업용 웹사이트에서 Google Maps API를 사용할 수 있나요?
-
고객이 귀하의 사이트에 무료로 액세스할 수 있는 한은, Google Maps API를 사용할 수 있습니다. 예를 들어, 귀하의 웹사이트가 광고의 지원을 받는 것은 아마도 Google Maps API 서비스 약관 내에 해당할 것입니다. 정보를 지도에 표시하기 위해 사람들에게 비용을 청구하는 경우(예: 주택 매매 정보 표시), Google Maps API를 사용하여 이 정보를 사이트의 무료 부분에 표시한다면, 이 또한 Google Maps API 서비스 약관을 충족하는 것입니다.
그러나 모든 상업적 용도가 허용되는 것은 아닙니다. 예를 들어, 귀하의 사이트가 다음 기준을 충족하는 경우에는 적절한 Google Maps API for Work 라이선스를 구입해야 합니다.
- 유료 고객만 사이트를 이용할 수 있는 경우.
- 귀하의 회사 또는 인트라넷 내에서만 사이트에 액세스할 수 있는 경우.
- 기업 발송, 차량 관리, 비즈니스 자산 추적 또는 이와 유사한 애플리케이션과 관련된 경우.
Google은 언제든지 Google Maps API 사용을 보류하거나 종료할 권리를 보유한다는 점을 명심하고, 서비스 약관을 자세히 읽어보세요.
- 추적 애플리케이션에서 Google Maps API를 사용할 수 있나요?
-
애플리케이션을 공공이 무료로 이용할 수 있고 서비스 약관을 준수한다면, Google Maps API로 실시간 데이터를 표시(추적)하는 데 제한이 없습니다. 내부 전용 애플리케이션의 경우, Google Maps API for Work를 사용해야 합니다. 자세한 내용은 서비스 약관의 섹션 10.4를 참조하세요.
- 웹용이 아닌 애플리케이션에서 Google Maps API를 사용할 수 있나요?
-
예. 서비스 약관의 기타 제한을 준수하기만 한다면, 이제 Google Maps API를 데스크톱 애플리케이션에서 사용할 수 있습니다. 참고로, 데스크톱 애플리케이션이 "공공 액세스 가능"으로 간주되려면, 애플리케이션을 다운로드할 수 있는 공공 액세스 가능 웹 페이지가 있어야 합니다. 자세한 내용은 서비스 약관의 섹션 9.1을 참조하세요.
Google Maps JavaScript API는 지원되는 브라우저 중 하나에서 실행될 때만 지원됩니다.
- 암호로 보호된 사이트에서 Google Maps API를 사용할 수 있나요?
-
예, 사용할 수 있습니다. 하지만 암호로 보호된 웹사이트에서 Google Maps API를 사용하기 전에 서비스 약관을 참조해야 합니다. 소비자가 무료로 쉽게 암호를 신청할 수 있거나 암호로 보호된 지도의 목적이 행정 등 공공 이용 지도를 개선하는 것이라면, 아마도 귀하의 사이트는 서비스 약관 내에 해당할 것입니다. 이 경우가 아니라면, Google Maps API for Work를 사용해야 합니다.
- Google Maps API 애플리케이션의 스크린샷을 인쇄 자료 또는 오프라인 미디어에서 사용할 수 있나요?
-
Google 지도 이미지를 인쇄 자료 및 오프라인 미디어에서 사용할 경우, 다음 주소에 게시된 권한 가이드라인의 적용을 받습니다:
- 제 콘텐츠가 Google 검색 결과에 포함되지 않도록 선택하려면 어떻게 하나요?
-
저희는 이 데이터를 더 이상 수집하지 않습니다.
indexing매개변수는 사용이 중단되었으며 영향이 없습니다. 더 이상 명시적으로 거부를 선택할 필요가 없으며, 편리한 시간에 이 매개변수를 빨리 제거하는 것이 좋습니다.검색 결과에서 자신의 페이지나 사이트를 제거하려면, 웹마스터 도움말 센터에서 제공하는 지침을 따르세요.
- JavaScript Maps API를 사용할 때 어떤 정보가 Google로 전송되나요?
-
JavaScript Maps API를 사용 중인 경우, 다음과 같은 정보가 Google로 전송됩니다.
- 지도 타일과 저작권을 검색하기 위한 지도 크기 및 위치
- 지오코딩을 위한 주소
- 길찾기 및 고도 요청
- 주변의 장소를 검색하려는 위치
- KmlLayer 사용 시 KML
- 제 웹사이트에 저장하여 서비스 중인 Google Static Maps API를 사용하여 지도 이미지를 생성할 수 있나요?
-
귀하의 웹사이트에서 Google Static Maps API를 사용하여 생성된 이미지의 복사본을 저장하고 서비스하지 못할 수 있습니다. 정적 이미지가 필요한 모든 웹 페이지는 HTML
img태그의src특성이나 HTMLdiv태그의 CSSbackground-image특성을 Google Static Maps API에 직접 연결해야 하므로, 모든 지도 이미지는 웹 페이지의 HTML 콘텐츠 내에 표시되며, Google에 의해 최종 사용자에게 직접 서비스됩니다.
사용 제한 및 결제
- 어떤 Google Maps API에 사용 제한이 있나요?
-
Google Maps API는 표준 API 사용 시 무료 사용 제한 및 예측 가능한 초과분 가격 책정, 기업 배포 시 연간 계약을 통해 광범위한 사용 사례에서 무료로 제공됩니다.
다음 API는 사용 제한이 없습니다.
다음 Maps API에는 사용 제한이 적용됩니다. 사용 제한 세부정보를 보려면 해당 API를 클릭하세요.- Google Maps JavaScript API
- Google Static Maps API
- Google Street View Image API
- Google Maps Directions API
- Google Maps Distance Matrix API
- Google Maps Elevation API
- Google Maps Geocoding API
- Google Maps Geolocation API
- Google Maps Roads API
- Google Maps Time Zone API
Maps API는 표준 서비스 약관을 준수하여 배포되어야 합니다.
- Google Maps API의 사용 제한이란 무엇인가요?
-
대부분의 Google Maps API에는 Google Developers Console에서 설정 가능한 하루당 무료 할당량이 있습니다. 하루당 기본 및 최대 쿼리 수는 API마다 다릅니다. 결제를 활성화하거나 프리미엄 라이선스를 구입하여 하루당 무료 제한을 늘릴 수 있습니다.
- Web Services API:
Google Maps Web Services API에는 하루당 2,500건의 무료 요청이 포함됩니다. 더 높은 일일 할당량(하루당 최대
100,000 )에 액세스할 수 있도록, 저희는 선불 가격을 제공합니다.선불을 선택할 수 있는 .
- Web API:
Google Maps JavaScript API, Google Static Maps API 및 Google Street View Image API에는 하루당
25,000 건의 지도 로드 기본 일일 제한이 있습니다. 귀하의 사이트나 애플리케이션이 90일 이상의 연속 기간 중에 하루당25,000 건 이상의 지도 로드를 생성하면, 저희가 귀하에게 결제 옵션을 알려드리기 위해 연락을 드릴 것입니다. 제한을 넘어가더라도 걱정하지 마십시오. 귀하의 API 액세스가 즉시 차단되거나 사이트에 오류 메시지가 표시되지는 않을 것입니다.
다음 사항의 정확한 정의에 대해서는 구체적 질문을 참조하세요.
참고: 공공의 이익에 부합한다고 여겨지는 애플리케이션(Google의 판단에 따라 결정)에는 이러한 사용 제한이 적용되지 않습니다. 예를 들어, 재해 구조용 지도는 상업적 조직에 의해 개발되고 호스팅되더라도 사용 제한이 적용되지 않습니다. 또한, Google Maps API의 지오코딩 제한이나 내부 사용량을 더 많이 필요로 하는 비영리 조직이 자격을 갖춘 경우에는 Google Earth Outreach 인가 프로그램을 통해 Google Maps API for Work 라이선스를 신청할 수가 있습니다.
- Web Services API:
- 사용 할당량은 어떻게 계산되나요?
-
사용 할당량의 계산 방식은 API에 따라 다릅니다. Web Services API는 요청 수를 사용합니다(참고로, Google Maps Distance Matrix API는 요소 수를 사용합니다). Web API는 지도 로드를 사용하여 사용 할당량을 계산합니다.
Google Maps Distance Matrix API의 경우, API로 전송되는 각 쿼리는 허용된 요소 수로 제한되며, 여기에서 출발지 수에 목적지 수를 곱하면 요소 수가 됩니다.
참고: Google Maps API Web Services의 사용을 제한하는 할당량 유형은 다음의 두 가지가 있습니다: 장기간(하루당 할당량) 및 단기간(요청 속도 할당량). 또한 추가적인 제한(예: Elevation API의 요청당 위치 수 제한)이 API에 설정될 수도 있습니다. 하루당 할당량 이외에도, Image API에는 최대 이미지 해상도가 포함됩니다. 자세한 내용은 각 Google Maps API의 사용 제한 페이지를 참조하세요.
- Google Maps Web API에 사용 제한이 적용되는 상황에서 '지도 로드'는 어떻게 구성되나요?
-
다음과 같은 경우 단일 지도 로드가 발생합니다.
- 웹 페이지 또는 애플리케이션에 의해 로드될 때 Google Maps JavaScript API를 사용하여 지도가 표시되는 경우
- 지도를 표시하지 않았던 웹 페이지 또는 애플리케이션에서 Google Maps JavaScript API를 사용하여 스트리트 뷰 파노라마가 표시되는 경우
- Google Static Maps API에서 지도 이미지를 단일 요청하는 경우 또는
- Google Street View Image API에서 파노라마 이미지를 단일 요청하는 경우
일단 지도가 로드된 후에는, 사용자가 지도와 상호작용하는 수준은 사용 제한에 영향을 미치지 않습니다. 참고로, Maps API를 사용하여 동일 페이지에 지도를 이미 표시했던 애플리케이션이 Google Maps JavaScript API를 사용하여 스트리트 뷰 파노라마를 표시하는 경우, 추가적인 지도 로드가 발생하지 않습니다.
Google Maps API for Work 애플리케이션은 페이지 뷰로 제한되며, 이것은 지도 로드와는 약간 다릅니다. 자세한 내용은 Google Maps API for Work FAQ를 참조하세요.
- 제 사용 할당량을 어떻게 모니터링하나요?
-
Google Developers Console에서 개별 API의 사용 할당량을 모니터링할 수 있습니다.
- 프로젝트 드롭다운 메뉴에서, 검토하려는 API가 포함된 프로젝트를 선택합니다.
- 활성화된 API 목록에서, API의 이름을 클릭합니다.
- 페이지 상단 부근에서, Quota 또는 Usage를 클릭합니다.
참고: 전체 프로젝트에 대한 트래픽 보고서와 결제 정보를 보려면, 먼저 결제를 활성화하십시오.
- API 사용량 모니터링, 필터링 및 제한에 대해 자세히 알아봅니다.
- 사용 제한을 초과하면 어떻게 되나요?
-
특정 Google Maps API의 사용 제한을 초과하면, API에서 오류 메시지를 반환합니다. 이 제한을 반복해서 초과할 경우, API에 대한 액세스 권한이 일시적으로 차단될 수 있습니다.
- Web Services API
Google Maps API Web Services의 경우, 사용을 제한하는 할당량 유형은 다음의 두 가지가 있습니다: 장기간(하루당 할당량) 및 단기간(요청 속도 할당량). 사용 제한을 초과했거나 서비스를 남용한 경우, 웹 서비스에서 특정한 오류 메시지를 반환합니다. 제한을 계속 초과할 경우, 웹 서비스에 대한 액세스 권한이 차단될 수 있습니다.
다음의 경우 Google Maps API Web Services의 사용 제한을 초과할 수 있습니다.
- 하루당 너무 많은 요청을 전송하는 경우.
- 너무 빨리 즉, 초당 너무 많은 요청을 전송하는 경우.
- 너무 오랫동안 너무 빨리 요청을 전송하거나 웹 서비스를 남용하는 경우.
- 다른 사용 제한(예: Elevation API의 요청당 위치 수 제한)을 초과하는 경우.
참고: 다음의 네 가지 Web Services API에는 JavaScript API에서 사용 가능한 것과 동일한 클라이언트측 서비스가 있습니다. Directions, Distance Matrix, Elevation 및 Geocoding. 클라이언트측 서비스 API에는 다른 제한이 적용됩니다. JavaScript API는 지도 세션별로 속도가 제한되므로, 요청이 사용자들 간에 분산됩니다. 이 경우 사용자 수가 증가함에 따라 브라우저 기반 사용량을 확장할 수 있습니다.
- Web API
Google Maps JavaScript API v3, Google Static Maps API 및 Google Street View Image API의 경우, 귀하의 사이트 또는 애플리케이션이 90일 연속 기간 중에 하루당
25,000 건의 지도 로드를 초과하는 경우, Google이 귀하에게 결제 옵션에 대한 정보와 함께 연락을 드릴 것입니다. 이 때 저희가 구입 시한을 지정해 드리며, 이 시한까지는 지도 표시에 변화가 없으며 귀하의 웹사이트가 계속해서 정상적으로 작동합니다.구입 시한이 지났는데도 귀하가 결제 활성화를 수행하지 않거나 Google Maps API for Work 라이선스를 구입하지 않은 경우, 웹사이트의 지도는 계속해서 작동하지만 하루당 최초
25,000 건의 지도 로드에 대해서만 작동합니다. 이 숫자를 넘어가면 API가 작동을 중단합니다.
사용 제한 초과됨
사용 제한을 초과하면
OVER_QUERY_LIMIT상태 코드가 응답으로 나타납니다.즉, 웹 서비스는 정상적인 응답 제공을 중단하고, 더 많은 사용량이 다시 허용될 때까지 상태 코드
OVER_QUERY_LIMIT만을 반환합니다. 이 상황은 다음과 같은 경우에 발생할 수 있습니다.- 애플리케이션이 초당 너무 많은 요청을 전송하여 오류가 수신되고 몇 초 이내의 경우.
- 애플리케이션이 하루당 너무 많은 요청을 전송하여 오류가 수신되고 향후 24시간 이내의 경우. 일일 할당량은 태평양 시간으로 자정에 재설정됩니다.
하루당 사용 제한을 정기적으로 초과하는 경우, 다음 사항을 고려하세요.
- Google Maps API를 더 효율적으로 사용하도록 애플리케이션을 최적화하여 사용량을 낮춥니다.
- 프로젝트에서 결제 활성화를 수행하여 사용 제한을 늘립니다.
- Google Maps API for Work 라이선스를 구매합니다.
- Web Services API
- 제 사이트에 트래픽이 너무 많습니다. Maps API를 사용할 수 있나요?
-
예. 그러나, 애플리케이션이 사용하는 Google Maps API의 사용 제한에 친숙해 지는 것이 좋습니다.
-
귀하의 회사 또는 조직에 다음 사항이 필요할 경우, Google Maps API 프리미엄 플랜을 구매해야 합니다.
- 24시간 기술 지원을 포함한 SLA
- Google 지도가 포함된 제품 또는 서비스를 판매하기 위한 역량
- 내부 애플리케이션 또는 웹사이트에 Google Maps API를 사용하기 위한 역량
- 특정한 크기의 할당량
- 기존 Maps API for Work 라이선스로 사용이 가능한 프리미엄 기능
Google Maps API 프리미엄 플랜을 어떻게 구매하나요?
Google Maps API 프리미엄 플랜을 구매하기 위한 자세한 내용과 애플리케이션의 예상 사용량에 따른 가격 견적을 받아보시려면, Google 영업 담당자에게 문의하세요.
- 제 웹사이트나 애플리케이션이 갑자기 인기가 있어지면, 제 지도가 작동을 멈추나요?
-
Web Services API를 사용 중인 경우, 하루당 2,500건의 무료 요청이 허용됩니다. 자동 결제에 등록하면 무료 할당량 초과 시에, 하루당 최대
100,000 건의 요청까지 선불 할당량에 액세스할 수 있습니다.Google Maps JavaScript API, Google Static Maps API 또는 Google Street View Image API를 사용 중인 경우는 그렇지 않으며, 지도가 계속해서 작동합니다. 단기간에 사용량이 급증하는 사이트를 고려하여, 90일 연속 기간 중에 사용 제한을 초과한 사이트에 대해서만 사용 제한이 적용됩니다.
- 초과 사용량은 어떻게 계산하고 결제하나요?
-
각 Google Maps API 서비스의 무료 할당량을 초과하는 초과 사용량은 하루가 끝날 때 계산됩니다.
Web Services API는 하루당 2,500건의 무료 요청을 제공합니다. 결제 활성화를 수행하여 더 높은 할당량에 액세스한 경우, 하루당 2,500건의 요청을 초과하면, 하루 최대
100,000 건까지 1,000건의 추가 요청당 $0.50 USD의 비용이 청구됩니다.Google Maps JavaScript API, Google Static Maps API 및 Google Street View Image API는 하루당
25,000 건의 무료 지도 로드를 제공합니다. 귀하의 사이트가 90일 연속 기간 중에 매일 초과 사용량을 생성하는 경우, Google이 귀하에게 결제 옵션에 대한 정보와 함께 연락을 드릴 것입니다.사용 제한을 초과하면 어떻게 되는지에 대해 자세히 알아봅니다.
결제 활성화를 선택하면 신용 카드 세부정보를 제공해야 합니다. 귀하의 초과 사용량은 하루가 끝날 때마다 계속해서 계산되며, 제공된 신용 카드에 청구된 총 금액이 매달 말에 계산됩니다. 가격은 아래와 같습니다.
- Google Maps API를 사용하는 비용은 얼마나 되나요?
-
사용 제한을 넘지 않는 요청 또는 지도 로드 볼륨을 생성하는 애플리케이션은, Google Maps API 서비스 약관의 요구사항을 충족하면, 무료로 Google Maps API를 사용할 수 있습니다.
Web Services API의 경우, Maps API 서비스가 일일 사용 제한을 초과하고 Google 개발자 콘솔을 사용하여 초과 할당량 구매를 온라인으로 선택하면, 아래 나타난 해당 서비스 요금이 초과 사용량에 부과됩니다.
Google Maps JavaScript API v3, Google Static Maps API 및 Google Street View Image API의 경우, 90일 연속 기간 중에 Maps API 서비스가 일일 사용 제한을 초과하고 귀하가 Google 개발자 콘솔을 사용하여 초과 지도 로드 구매를 온라인으로 선택하면, 아래 나타난 해당 서비스 요금이 초과 사용량에 부과됩니다.
참고로, 귀하의 사이트가 하루당 많은 볼륨의 지도 로드를 꾸준히 생성하는 경우에는, Google Maps API for Work 라이선스가 더욱 비용 효과적일 수 있습니다. 자세한 내용은 Google Maps API for Work 영업팀에 문의하세요.
Web Services API 사용 제한
(하루당)1000개의 초과 요청
(미화 달러 단위)Directions API 2,500 $0.50 Distance Matrix API 1 2,500 $0.50 Elevation API 2,500 $0.50 Geocoding API 2,500 $0.50 Geolocation API 2,500 $0.50 Roads API 2,500 $0.50 Time Zone API 2,500 $0.50 1 Google Maps Distance Matrix API 사용량은 하루당 요소 수를 기준으로 측정됩니다Web API 사용 제한
(하루당)1000개의 초과 지도 로드
(미화 달러 단위)Google Maps JavaScript API 25,000 *$0.50 Google Static Maps API 25,000 *$0.50 Google Street View Image API 25,000 *$0.50 * 결제는 90일 연속 기간 중에 사용 제한을 초과한 경우에만 발생합니다.참고로, 초과 할당량을 온라인으로 구매한다고 해서, 기존 서비스 약관에 따라 Google Maps API를 계속 사용할 수 있는 권한 이외의 다른 추가 권한이나 혜택을 부여하지는 않습니다.
- 가격을 다른 통화로도 볼 수 있나요?
-
현재는 미화 달러로만 가격을 보실 수 있습니다.
- 결제를 활성화했습니다. 제 청구서를 보려면 어떻게 하나요?
-
Google은 이전 달의 활동에 대해 매월 초에 지정된 결제 방법을 사용하여 귀하에게 비용을 청구합니다.
- 비용 및 결제 내역 보기 방법에 대해 알아봅니다.
- 송장 또는 결제 영수증 가져오기 방법에 대해 알아봅니다.
- 결제 알림 설정 및 관리 방법에 대해 알아봅니다.
- 예상치 못한 사용량 증가로 인해 많은 금액의 청구서를 받지 않으려면 어떻게 하나요?
-
Google Maps API는 무료 일일 할당량을 제공하며, 일일 청구 가능 한도를 설정합니다. 예상치 못한 사용량 증가를 방지하려면 일일 최대 사용량 한도를 설정하면 됩니다. 또한 결제 계좌의 청구액이 설정 한도에 도달하는 경우, 이메일 알림을 받을 수 있는 결제 알림을 설정할 수도 있습니다.
일일 청구 가능한 최대 한도 설정:
-
Web Services API의 경우:
표준 Web Services API는 매일
100,000 개까지 요청 또는 요소를 지원합니다. 프로젝트에서 결제 활성화를 수행할 때까지는, 프로젝트에서 하루당 무료 한도가 2,500개로 제한됩니다. 결제가 활성화된 경우, 하루당 2,500건의 요청을 초과하면, 하루 최대100,000 건까지 1,000건의 추가 요청당 $0.50 USD의 비용이 청구됩니다.많은 금액의 청구서를 받지 않으려면, 사용량에 일일 한도를 설정하여 예상치 못한 사용량 증가를 방지할 수 있습니다. 현재, 청구 가능한 최대 한도는 기본적으로 하루당
100,000 개 요청입니다. 이 한도를 변경하려면, Google Developers Console에서 해당 API의 Quotas 페이지에서 Total Quota 옆의 편집 아이콘을 클릭합니다.참고: 해당 날짜에 API 사용량이 청구 가능 한도에 도달하면, 이 날짜의 남은 시간 동안 애플리케이션이 API에 액세스할 수 없습니다. 자세한 내용은 사용 제한을 초과하면 어떻게 되나요?를 참조하세요.
Web API의 경우:
Google Maps JavaScript API v3, Google Static Maps API 및 Google Street View Image API의 경우, 90일 연속 기간 중에 사이트가
25,000 개의 지도 로드 무료 일일 사용 한도를 초과할 때까지는 API 사용 제한이 적용되지 않습니다. 표준 Google Maps Web API 사용 시에 무료 사용 제한을 초과하면, 프로젝트에서 결제 활성화를 수행하여 초과 지도 로드를 온라인으로 구입할 수 있습니다. 결제가 활성화된 경우, 무료 사용 제한을 초과하면, 하루 최대1,000,000 건까지 1,000건의 추가 요청당 $0.50 USD의 비용이 청구됩니다.결제가 시작된 후에 많은 금액의 청구서를 받지 않으려면, 사용량에 일일 한도를 설정하여 예상치 못한 사용량 증가를 방지할 수 있습니다. 현재, 청구 가능한 최대 한도는 기본적으로 하루당
1,000,000 개 요청입니다. 이 한도를 변경하려면, Google Developers Console에서 해당 API의 Quotas 페이지에서 Total Quota 옆의 편집 아이콘을 클릭합니다.참고: 해당 날짜에 API 사용량이 청구 가능 한도에 도달하면, 이 날짜의 남은 시간 동안 애플리케이션이 API에 액세스할 수 없습니다. 자세한 내용은 사용 제한을 초과하면 어떻게 되나요?를 참조하세요.
결제 알림 설정 및 관리:
결제 계좌의 청구액이 설정 한도에 도달하는 경우, 이메일 알림을 결제 관리자에게 전송하도록 결제 알림을 설정하세요. 결제 계좌의 예상 청구액이 한도의 50%, 90% 및 100%를 초과할 때, 결제 관리자에게 이메일 알림이 전송됩니다.
- 결제 알림 설정 및 관리 방법에 대해 알아봅니다.
권장 사항: 귀하의 사이트가 하루당 많은 볼륨의 요청 또는 지도 로드를 꾸준히 생성하는 경우에는, Google Maps API for Work 라이선스가 더욱 비용 효과적일 수 있습니다. 자세한 내용은 Google Maps API for Work 영업팀에 문의하세요.
-
결제 활성화
결제를 활성화하고 Google Maps API의 더 높은 할당량을 해제할 수 있도록 Google 개발자 콘솔에서 몇 가지 작업을 완료하는 방법을 소개하겠습니다.
- 프로젝트 생성 또는 선택
- 결제 프로필 설정 또는 선택
- 프로젝트에서 결제 활성화
Google Maps API 사용
- 다른 지도 제품에는 어떤 키나 자격 증명을 사용해야 하나요?
-
Google Maps API를 사용할 때마다 요청을 검증하기 위해 키 또는 기타 자격 증명을 포함해야 합니다. 필요한 자격 증명의 유형은 API에 따라 다르며, 표준 또는 프리미엄 라이선스 보유 여부에 따라 다릅니다.
Google Maps API는 Android, iOS, 웹 앱 및 HTTP 웹 서비스를 통해 이용할 수 있습니다. API의 지도 제품군에서는 특정 제품을 로드하거나 사용할 때 전달되어야 하는 다양한 자격 증명을 사용합니다. 사용되는 자격 증명은 제품마다 다릅니다.
- API 키: API 키는 Google Developers Console을 사용하여 생성되는 고유 식별자입니다. API 키는 일반적으로 표준 API와 함께 사용됩니다. 일반적으로 프리미엄 고객은 API 키 대신 클라이언트 ID를 사용합니다.
각 플랫폼의 API는 특정 유형의 키가 필요합니다. 네 가지 유형의 키를 사용할 수 있습니다.
- 서버 키 - Web Services API와 사용할 경우.
- 브라우저 키 - Web API와 사용할 경우.
- Android 키 - Android API와 사용할 경우.
- iOS 키 - iOS API와 사용할 경우.
동일한 플랫폼의 API는 동일한 키를 사용할 수 있습니다.
참고: Google Maps API for Work 및 프리미엄 사용자는 반드시 등록 시에 생성되었던 프로젝트를 선택해야 합니다. 이 프로젝트는 이름에 Business 또는 Work라는 단어를 포함합니다.
키로 API 로드 예시:
&key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo - 클라이언트 ID: Google Maps API for Work 또는 프리미엄 고객으로서 등록하시는 경우 클라이언트 ID가 귀하에게 제공됩니다.
클라이언트 ID로 API 로드 예시:
&client=gme-companyname - 디지털 서명: 디지털 서명은 Google Maps API for Work 및 프리미엄 고객만 사용합니다. 이 서명은 Google이 귀하에게 제공한 암호화 키를 사용하여 생성됩니다. 자세한 내용은 Google Maps API for Work 웹 서비스 문서를 참조하세요.
아래 표는 각 지도 제품에 사용되어야 하는 키/자격 증명을 나타냅니다.
API 표준 사용자 프리미엄 사용자 Google Maps Android API Android 키 Android 키 Google Places API for Android Android 키 사용할 수 없음 Google Maps SDK for iOS iOS 키 iOS 키 Google Places API for iOS iOS 키 사용할 수 없음 Google Maps JavaScript API 브라우저 키 클라이언트 ID Google Static Maps API 브라우저 키 클라이언트 ID + 디지털 서명 Google Street View Image API 브라우저 키 클라이언트 ID + 디지털 서명 Google Maps Embed API 브라우저 키 사용할 수 없음 Google Maps Directions API 서버 키 클라이언트 ID + 디지털 서명 Google Maps Distance Matrix API 서버 키 클라이언트 ID + 디지털 서명 Google Maps Elevation API 서버 키 클라이언트 ID + 디지털 서명 Google Maps Geocoding API 서버 키 클라이언트 ID + 디지털 서명 Google Maps Geolocation API 서버 키 서버 키 Google Maps Roads API 서버 키 서버 키 Google Maps Time Zone API 서버 키 클라이언트 ID + 디지털 서명 Google Places API Web Service 서버 키 서버 키 참고: 이전에는 다음과 같은 Maps API에 API 콘솔 키가 필요 없었습니다: Google Maps JavaScript API, Google Static Maps API, Google Street View Image API, Google Maps Geocoding API, Google Maps Directions API, Google Maps Distance Matrix API, Google Maps Elevation API 및 Google Maps Time Zone API. 이전 버전과의 호환성을 보장하기 위해 지금도 레거시 애플리케이션에는 이러한 지원이 제공되지만, 새 애플리케이션에는 더 이상 권장되지 않습니다.
- API 키: API 키는 Google Developers Console을 사용하여 생성되는 고유 식별자입니다. API 키는 일반적으로 표준 API와 함께 사용됩니다. 일반적으로 프리미엄 고객은 API 키 대신 클라이언트 ID를 사용합니다.
- 키 유형을 브라우저 키에서 서버 키로 어떻게 전환하나요?
-
중요: 브라우저 키와 함께 Web Services API를 사용 중인 경우, 2015 월 9월 1일부터는 요청이 실패하고 다음과 같은 오류 메시지가 나타날 수 있습니다: "이 IP, 사이트 또는 모바일 애플리케이션은 이 API 키를 사용할 권한이 없습니다." 서버 키를 사용하도록 전환해야 합니다.
API 키 유형을 전환하려면, 최소 한 개 이상의 서버 키가 필요합니다. 동일한 플랫폼의 API는 동일한 키를 사용할 수 있습니다. API 키는 Google Developers Console에서 획득합니다.
Web Services API에 대해 서버 키를 획득하려면, 다음을 수행하세요.
- Google 개발자 콘솔로 이동합니다.
- 프로젝트를 선택하거나 생성합니다.
- 새로운 API 키를 생성하려면, Add credentials 버튼을 클릭합니다.
- 자격 증명 유형의 목록에서 API key를 선택합니다.
- "Create a new key" 팝업 상자에서, Server key 버튼을 선택합니다.
- 서버 키에 이름을 지정하고, 원하는 IP 주소 제한(선택 항목)을 설정한 다음, Create를 클릭합니다.
- 새로운 서버 키가 생성되어 자격 증명 페이지에 나열됩니다. 참고로, 목록의 키는 유형별로 식별됩니다.
서버 키를 Web Services API 요청에 지정
새로운 서버 키를 요청에 지정하려면 해당 키를 key 매개변수의 값으로 포함합니다.
예:
Elevation API의 경우:
https://maps.googleapis.com/maps/api/elevation/json?locations=39.739,-104.984&key=YOUR_API_KEY
Geolocation API의 경우:
https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY
- 다음 오류를 어떻게 해결하나요? "이 IP, 사이트 또는 모바일 애플리케이션은 이 API 키를 사용할 권한이 없습니다."
-
이 오류를 유발할 수 있는 다음과 같은 다양한 상황이 있습니다.
- 브라우저 키와 함께 Web Services API를 사용 중입니다.
Web Services API는 서버 키를 사용해야 합니다. 키 유형을 브라우저 키에서 서버 키로 전환합니다.
- 서버 키에 대해 IP 주소 제한을 활성화했으며, 불법 IP 주소가 요청을 시도 중입니다.
- 브라우저 키에 대해 HTTP 참조 페이지 제한을 활성화했으며, 불법 참조 페이지가 요청을 시도 중입니다.
- 패키지 이름과 지문을 설정하여 Android 앱의 사용을 제한했으며, 불법 Android 앱이 요청을 시도 중입니다.
- 번들 식별자를 지정하여 iOS 앱에서의 요청을 제한했으며, 불법 iOS 앱이 요청 전송을 시도 중입니다.
API 키 자격 증명 보기 및 편집
API 키와 추가된 제한 사항을 보려면, 다음을 수행하세요.
- Google Developers Console로 이동합니다.
- 프로젝트 드롭다운 메뉴에서, 검토하려는 API 키가 포함된 프로젝트를 선택합니다.
- 키에 설정된 모든 제한을 비롯한 자격 증명 세부정보를 보려면, API 키 목록에서 키의 이름을 클릭합니다.
- 키에 설정된 모든 제한을 비롯하여 선택한 API 키의 전체 자격 증명이 표시됩니다. 여기서부터는, 필요에 따라 제한을 삭제하거나 업데이트할 수 있습니다.
- 브라우저 키와 함께 Web Services API를 사용 중입니다.
- Google Maps API의 각 버전에 소개되는 변경사항을 어떻게 찾을 수 있나요?
-
Google Maps JavaScript API 버전 간의 변경사항에 대한 목록은 다음 주소에서 유지 관리됩니다:
https://developers.google.com/maps/documentation/javascript/releases
또한 어떤 버전의 Google Maps API에서 특정 버그가 발생했는지 그리고 Google Maps API Issue Tracker를 사용하여 이 버그가 수정되었는지를 다음 주소에서 확인할 수 있습니다:
- 페이지가 로드된 후 이 페이지에 API를 비동기식으로 로드하려면 어떻게 하나요?
-
API를 로드할 때 콜백 매개변수를 지정하면 됩니다. 자세한 내용과 샘플 코드는 Maps API 문서의 시작하기 장에서 찾을 수 있습니다.
- 영어 이외의 다른 언어로 Google Maps API를 표시하려면 어떻게 하나요?
-
기본적으로 API는 사용자 위치나 브라우저 설정에 따라 가장 적절한 언어를 로드하려고 시도합니다. 일부 API에서는 요청을 수행할 때 명시적으로 언어를 설정할 수 있습니다. 각 API의 문서에 사용 가능한 언어를 설정하는 자세한 방법:
- JavaScript API 문서
- Google Maps Geocoding API
- Google Maps Directions API
- Google Maps Distance Matrix API
- Places API
언어 코드 언어 언어 코드 언어 ar 아랍어 kn 칸나다어 bg 불가리아어 ko 한국어 bn 벵골어 lt 리투아니아어 ca 카탈로니아어 lv 라트비아어 cs 체코어 ml 말라얄람어 da 덴마크어 mr 마라티어 de 독일어 nl 네덜란드어 el 그리스어 아니요 노르웨이어 en 영어 pl 폴란드어 en-AU 영어(호주) pt 포르투갈어 en-GB 영어(영국) pt-BR 포르투갈어(브라질) es 스페인어 pt-PT 포르투갈어(포르투갈) eu 바스크어 ro 루마니아어 eu 바스크어 ru 러시아어 fa 페르시아어 sk 슬로바키아어 fi 핀란드어 sl 슬로베니아어 fil 필리핀어 sr 세르비아어 fr 프랑스어 sv 스웨덴어 gl 갈라시아어 ta 타밀어 gu 구자라트어 te 텔루구어 hi 힌디어 th 타이어 hr 크로아티아어 tl 타갈로그어 hu 헝가리어 tr 터키어 id 인도네시아어 uk 우크라이나어 it 이탈리아어 vi 베트남어 iw 히브리어 zh-CN 중국어 간체 ja 일본어 zh-TW 중국어 번체 이 샘플 애플리케이션에서는 귀하의 언어에서 지도가 어떻게 보이는지를 아실 수 있습니다.
- SSL(HTTPS)를 통해 Google Maps API에 액세스할 수 있나요?
-
Google Maps JavaScript API, Google Static Maps API 및 Google Maps API Web Services는 이러한 API의 무료 버전 또는 Google Maps API for Work를 사용하는 개발자가 보안(HTTPS) 연결을 통해 액세스할 수 있습니다. SSL을 통해 API에 액세스하는 방법에 대한 정보는 해당 API의 문서를 참조하세요.
참고로, Google Static Maps API는 HTTPS를 사용하는 사용자 지정 아이콘 URL을 지원하지 않으며, 기본 아이콘이 표시됩니다.
- Google Maps API에서 버그를 신고하거나 새로운 기능을 요청하려면 어떻게 하나요?
-
버그로 의심될 수 있는 동작이 발생하는 경우, 먼저 이 동작을 관련 포럼에 올리세요. 이렇게 하면 다른 개발자가 버그를 검증하고 귀하의 코드에서 잠재적인 문제를 제외시킬 것입니다.
특정한 기능을 요청하려면, 이 또한 관련 포럼에 먼저 올려서, 귀하의 요구사항을 충족시키는 솔루션이 이미 있지 않은지 확인하세요.
새로운 버그를 식별했거나 Google Maps API의 기존 기능으로는 요구사항을 충족할 수 없는 것으로 확인되면, Google Maps API Issue Tracker를 사용하여 버그 또는 기능 요청을 보고해 주세요.
버그 또는 기능 요청을 Issue Tracker에 추가하기 전에, 해당 버그 또는 기능이 이미 추가되지 않았는지 확인하세요. 이미 추가된 경우, 해당 문제에 별점을 주어 관심을 표시하고 업데이트 알림을 받으실 수 있습니다.
- 이 오류는 무엇을 의미하나요?
-
Google Maps JavaScript API를 로드하는 중에 오류가 발생하면, 오류 메시지를 참조하여 해당 오류 코드의 설명을 찾아보세요.
- 다른 질문/문제가 있습니다. 누구에게 연락해야 하나요?
-
Google Developer Relations 팀은 공동으로 편집된 질문과 답변을 제공하는 사이트인 Stack Overflow를 프로그래머용으로 유지관리하고 있습니다. 이 사이트는 Google 지도 애플리케이션의 개발 및 유지관리에 대한 기술적인 질문을 올리는 데 적합한 사이트입니다. Stack Overflow에 질문을 올리는 방법에 대한 자세한 내용은지원 페이지에서 보실 수 있습니다.
도움을 요청할 때 최적의 결과를 얻으려면, 다음 사항을 명심하세요.
- 최신 논의를 검색하세요. 다른 누군가나 비슷한 문제를 겪었고 해결책을 찾아냈을 수도 있습니다.
- 가능하면 본인의 사이트 링크를 제출하세요. 코드를 온라인으로 보기가 쉽지 않은 경우, 코드 조각만 게시하세요.
- 이 문제의 해결에 도움이 될 수 있는 모든 관련 정보(브라우저 버전, 오류 및 기타 정보)를 제공하세요.
Google Maps API for Work 고객은 Google for Work 지원에 연락할 수도 있습니다.
Google Maps API 서비스
- 주소를 위도/경도 쌍으로 변환해야 합니다. Google Maps API에서 변환할 수 있나요?
-
예. 이 프로세스를 "지오코딩"이라고 합니다. 각 Google Maps API에는 지오코딩을 수행하기 위한 클래스가 포함됩니다. 클래스는 다음과 같습니다.
- Google Maps JavaScript API: google.maps.Geocoder
또한 Google은 지오코딩 웹 서비스도 제공하며, 이 서비스는 JSON 및 XML 형식으로 응답할 수 있는 REST 인터페이스를 제공합니다.
지오코더 요청에 적용되는 사용 제한을 숙지하고, Google Maps API를 사용하여 표시될 위치를 구할 목적이 아닌 다른 목적으로 지오코더를 사용하는 것은 서비스 약관을 위반하는 것임에 유의하십시오. Google Maps API 애플리케이션을 벗어나는 주소를 지오코딩하는 경우, 이 주소를 캐시에 저장했다가 나중에 Google Maps API 중 하나를 사용하여 표시할 수 있도록 HTTP 지오코더를 사용할 수는 있지만, 지오코딩 웹 서비스를 사용하여 획득한 위치를 다른 애플리케이션에서 사용하거나, 다른 수단으로 배포하거나 재판매할 수는 없습니다.
- 지오코딩을 사용할 수 있는 국가는 어디인가요?
-
현재 Google Maps API 지오코더에서 지원하는 국가를 보려면, Google 지도 커버리지 데이터를 참조하세요.
지오코딩된 위치의 정확성은 국가마다 다를 수 있으므로, 애플리케이션의 목적에 맞는 충분히 정확한 일치 항목이 발견되었는지 여부를 판별하려면, 반환된 location_type 필드를 사용해야 합니다. 참고로, 지오코딩 데이터의 가용성은 저희와 데이터 공급자와의 접촉에 따라 달라지므로, 가용성이 변경될 수가 있습니다.
현재 Google Maps API가 지원하는 않는 국가에서 지오코딩을 수행하려면, 다른 지오코딩 서비스의 이 목록을 찾아보세요.
- Google Maps API 지오코더가 Google 지도와 다른 위치를 제공하는 이유는 무엇인가요?
-
API 지오코더와 Google 지도 지오코더는 (국가에 따라) 다른 데이터 집합을 사용하는 경우가 있습니다. API 지오코더는 가끔씩 새로운 데이터로 업데이트되므로, 시간이 지남에 따라 결과가 변경되거나 개선되는 것을 보실 수 있습니다.
- 요청 성공 횟수를 극대화하려면, 지오코더 쿼리의 형식을 어떻게 지정해야 하나요?
-
지오코더는 거리 주소를 지리 좌표로 매핑하도록 설계되었습니다. 따라서, 쿼리의 성공 가능성을 극대화하려면 다음의 지침에 따라 지오코더 요청의 형식을 지정하는 것이 좋습니다.
- 해당 국가의 국내 우편 서비스에서 사용되는 형식에 따라 주소를 지정합니다.
- 해당 국가의 우편 서비스에서 정의되는 형식의 주소에 포함되지 않는 추가적인 주소 요소(예: 사업체 이름, 부서 번호, 방 번호 또는 스위트 번호)는 지정하지 마십시오.
- 가능한 경우 건물 이름보다는 구역의 번지를 사용합니다.
- 가능한 경우 교차로를 지정하기보다는 번지 주소를 사용합니다.
- 주변 랜드마크와 같은 '힌트'를 제공하지 마십시오.
- 지오코딩을 위해, 번호가 있는 고속도로에서 미국 주소를 어떤 형식으로 지정해야 하나요?
-
Google Maps API 지오코더에서는 번호가 있는 미국 고속도로의 주소를 다음과 같이 지정해야 합니다.
-
카운티 도로:
"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 지오코딩 서비스를 사용해야 하나요?
-
다음 문서 참조: Geocoding Strategies: 서로 다른 지오코딩 전략의 장점과 단점을 상세히 설명합니다.
- Google Maps API로 자동차 길찾기를 제공하려면 어떻게 하나요?
-
Google Maps JavaScript API에서는 google.maps.DirectionsService 클래스를 통해 자동차 길찾기를 제공할 수 있습니다. 이 클래스는 기본 및 다중 지점 자동차 길찾기에 대한 단계별 액세스를 제공합니다. DirectionsRenderer 클래스는 오버레이와 길찾기 패널을 자동으로 생성할 수 있습니다. 추가 예시가 문서에서 제공됩니다.
또한 자동차 길찾기를 위해 Google 지도에 쉽게 링크할 수 있습니다. Google 지도에서 자동차 길찾기에 대해 다음 형식을 사용하도록 제안합니다:
http://maps.google.com/maps?saddr={start_address}&daddr={destination_address} - 자동차 길찾기를 사용할 수 있는 국가는 어디인가요?
-
현재 Maps API에서 자동차 길찾기가 지원되는 국가를 보려면, Google 지도 커버리지 데이터를 참조하세요. 참고로, 자동차 길찾기 데이터의 가용성은 저희와 데이터 공급자와의 접촉에 따라 달라지므로, 가용성이 변경될 수가 있습니다.
- 대중교통 길찾기를 사용할 수 있는 국가는 어디인가요?
-
Google Maps 길찾기 서비스는 Transit Coverage List에 나열된 모든 대중교통 공급자를 지원합니다(일본의 공급자는 제외).
- Google Maps JavaScript API에서 지원되는 KML & GeoRSS의 기능은 무엇인가요?
-
Javascript API의 KmlLayer 클래스를 사용하여 개발자가 KML/KMZ 및 GeoRSS 파일을 지도 상단에 중첩되게 배치할 수 있습니다. 예시는 여기를 참조하세요.
현재
KmlLayer클래스에서 지원되는 KML 기능이 다음 사이트에 설명되어 있습니다: - Google Maps JavaScript API의 KmlLayer 클래스를 사용하여 표시할 수 있는 KML의 크기 및 복잡성에 대한 제한은 무엇인가요?
-
KmlLayer클래스를 사용하여 KML을 표시할 때의 크기 및 복잡성 제한이 다음 사이트에 설명되어 있습니다: - Google Static Maps API에서 지원되는 마커 또는 경로 교점의 최대 수는 몇 개인가요?
-
Google Static Maps API에서 지원되는 마커 또는 경로 교점의 수는 제한이 없습니다. 사용자 지정 아이콘을 사용 중인 경우, 요청당 최대 5개의 고유 아이콘을 지정할 수 있지만, 각 아이콘을 지도 내에서 여러 번 사용할 수는 있습니다.
참고로, Google Static Maps API URL에는 최대 약 2,000자가 포함될 수 있으며, 이 때문에 각 위도/경도 쌍을 지정할 때 사용되는 소수점 자리 수에 따라 지정이 가능한 마커 및 경로 교점의 수가 제한됩니다. 사용되는 소수점 자리수와 지구상의 정확도 사이에 어떤 관계가 있는지에 대해서는 Decimal Degrees에 대한 Wikipedia 문서를 참조하세요.
- 중국에서는 Google Maps API에 액세스할 수 없는 이유가 무엇인가요?
-
Google Maps API는 중국 내의 도메인
maps.google.cn에서 서비스됩니다. 이 도메인은 https를 지원하지 않습니다. 중국에서 Google Maps API에 요청을 하는 경우,https://maps.googleapis.com을http://maps.google.cn으로 바꿔 주세요.예:
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA
다음과 같이 변경:
http://maps.google.cn/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA
Google Maps JavaScript API는 다음과 같은 부트스트랩으로 로드될 수 있습니다.
<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY" type="text/javascript"> </script>
