자주 묻는 질문(FAQ)

이 페이지는 이전 Maps APIs for Work 또는 Maps API for Business 라이선스가 있는 고객만을 위한 것입니다. 이 페이지는 2016년 1월에 출시된 새 Google Maps API 프리미엄 플랜가 있는 고객에게는 적용되지 않습니다.

이 FAQ에서는 이전 Google Maps APIs for Work 라이선스에 관련된 질문만을 다룹니다.

모든 Google Maps APIs에 대한 공통적 질문은 Google Maps APIs FAQ를 참조하세요.

시작하기

사용 제한

Google Maps APIs 사용

KML

URL 서명

스타일 지정

시작하기

Google Maps APIs for Work에 어떤 제품이 포함되어 있나요?

다음과 같은 Google 제품이 Google Maps APIs for Work에 포함됩니다. 다음 제품을 사용하는 애플리케이션은 Google Maps APIs for Work SLA에 포함되며 기술 지원을 받을 수 있습니다.

다음 API는 Google Maps APIs for Work에 포함되지 않습니다. 이 API를 사용하는 애플리케이션은 이 API의 게시된 서비스 약관을 준수해야 하며 Google Maps APIs for Work SLA가 적용되지 않거나 현재 기술 지원을 받을 수 없습니다.

Google Maps APIs for Work의 기술 지원을 문의하려면 어떻게 하나요?

Google Maps APIs for Work 고객은 다음에서 Google Cloud Support Portal을 사용하여 Google 지원에 새로운 지원 케이스를 열 수 있습니다.

https://google.secure.force.com/

포털에 액세스하려면 사용자 이름과 암호가 필요합니다. 계정이 없을 경우 이 양식을 작성하세요.

Google Cloud Support Portal의 로그인 자격 증명을 재설정하려면 어떻게 하나요?

암호가 기억나지 않습니다. 이 링크는 Google Cloud Support Portal 로그인 페이지에서도 사용이 가능합니다.

Google Maps APIs for Work의 서비스 약관이란 무엇인가요?

Google Maps APIs for Work 고객인 경우, Google Maps APIs의 사용에 대해 기술된 약관의 계약 내용을 참조하세요.

사용 제한

Google Maps APIs for Work 사용량은 어떻게 추적, 보고되나요?
  • Google Maps APIs for Work 라이선스의 경우, Maps JavaScript API, Street View Image API 및 Static Maps API는 페이지 뷰에 기초하여 사용량이 계산됩니다.

    페이지 뷰 정의:

    1. * Google Maps JavaScript API의 단일 페이지 로드. Maps JavaScript API는 API를 사용하는 페이지가 다시 로드될 때마다 다시 로드됩니다. 사용자의 지도 상호작용(예: 패닝, 확대/축소, 지도 유형 변경)은 페이지 뷰가 증가하지 않습니다. 그러나 API를 지도 표시에 사용하지 않더라도API가 페이지에 로드되면 페이지 뷰가 생성됩니다. 페이지 템플릿에 API를 로드하는<script> 태그를 포함하고 선택적 사용자 액티비티에 응답할 때만 지도를 표시하는 페이지에 API를 비동기적으로 로드하는 것이 좋습니다.
    2. *Google Street View Image API 또는 Google Static Maps API 이미지에 대한 단일 요청.

    Google Maps APIs for Work 고객은 Google Cloud Support Portal(https://google.secure.force.com/)에서 페이지 뷰를 추적할 수 있습니다.

    Google Maps APIs 표준 및 프리미엄 플랜 애플리케이션은 지도 로드로 제한됩니다. 지도 로드는 페이지 뷰와 다소 차이가 있습니다. 자세한 내용은 Google Maps APIs FAQ를 참조하세요.

  • Google Maps Mobile SDK for Work는 지도 로드를 사용하여 사용량을 추적합니다. 자세한 내용은 Google Maps Mobile SDK 사용 제한을 참조하세요.
  • Google Maps APIs 웹 서비스는 요청을 사용하여 사용량을 추적합니다(Google Maps Distance Matrix API는 요소를 사용하여 사용량 추적). 자세한 내용은 Google Maps APIs 웹 서비스 사용 제한을 참조하세요.
Google Maps JavaScript API의 사용 제한이란 무엇인가요?

페이지 뷰(상기 정의)로 간주되는 요청은 Google Maps APIs for Work 라이선스로 구매한 총 페이지 뷰 개수에 적용됩니다. 이 한도에 도달하면 라이선스를 신속히 갱신해야 합니다.

Google Maps Mobile SDK for Work의 사용 제한이란 무엇인가요?

각 로드는 Google Maps Mobile SDK for Work 라이선스로 구매한 총 지도 로드 개수에 적용됩니다. 이 한도에 도달하면 라이선스를 신속히 갱신해야 합니다. 자세한 내용은 Google Maps Mobile SDK 사용 제한을 참조하세요.

Google Maps APIs 웹 서비스의 사용 제한이란 무엇인가요?

Google Maps APIs for Work 고객에게는Google Maps APIs 웹 서비스에 다음과 같은 사용 제한이 제공됩니다.

웹 서비스 제한
길찾기 연간 계약 구매를 기준으로, 24시간당 100,000개 요청부터 시작하는 일일 할당량. 요청당 최대 23개 경유지. 초당 요청 10개의 속도 제한.
고도 연간 계약 구매를 기준으로, 24시간당 100,000개 요청부터 시작하는 일일 할당량. 요청당 최대 512개 지점. 초당 요청 10개의 속도 제한.
지오코딩 연간 계약 구매를 기준으로, 24시간당 100,000개 요청부터 시작하는 일일 할당량. 초당 요청 10개의 속도 제한.
거리 행렬 연간 계약 구매를 기준으로, 24시간당 100,000개 요소부터 시작하는 일일 할당량. 쿼리당 최대 요소 625개 및 10초당 최대 1,000개 요소.
시간대 연간 계약 구매를 기준으로, 24시간당 100,000개 요청부터 시작하는 일일 할당량. 초당 요청 10개의 속도 제한.
도로 연간 계약 구매를 기준으로, 24시간당 100,000개 요청부터 시작하는 일일 할당량. 초당 요청 10개의 속도 제한. 각 요청에 최대 100개의 지점이 포함될 수 있습니다.

이 제한은 각 Google Maps APIs for Work 클라이언트 ID 또는 개발자 프로젝트에 적용되고 해당 클라이언트 ID 또는 개발자 프로젝트를 사용하는 모든 애플리케이션과 IP 주소에서 공유됩니다.

사용 제한이 더 필요할 경우Google Maps APIs for Work 계정 관리자에게 구매 정보를 문의하세요.

Google Places API와 Google Maps Geolocation API의 사용 제한이란 무엇인가요?

Google Maps APIs for Work 계약에서 Google Places API 또는 Google Maps Geolocation API를 구매했다면 제한이 API의 할당량 Quotas 섹션에 표시되고 Google API Console에서 확인할 수 있습니다. 한도를 높여야 할 경우 Google Cloud Support Portal을 통해 Google에 문의하세요.

Google Maps JavaScript API에서 전송한 지오코딩 요청의 사용 제한은 무엇인가요?

Google Maps APIs for Work 고객에게는 Maps JavaScript API에서 전송한 지오코딩 요청에 다음 사용 한도가 제공됩니다.

서비스 사용 중인 API 제한
지오코딩
Google Maps JavaScript API

지오코딩은 특정 IP 주소를 공유하는 사용자 수와 관계없이 일일 할당 및 속도 제한이 있으며 이는 각 사용자 세션에 적용됩니다.

이 서비스는 일괄 지오코딩 작업에 사용해서는 안 됩니다. 일괄 지오코딩 작업에는 Google Maps Geocoding API를 사용해야 합니다.

Google Maps 이미지 API의 사용 제한이란 무엇인가요?

Google Maps APIs for Work 고객에게는 Google Maps 이미지 API에 다음과 같은 사용 한도가 제공됩니다.

서비스 제한
Google Static Maps API

요청은 Google Maps APIs for Work 라이선스로 구매한 전체 페이지 뷰에 적용됩니다.

최대 이미지 크기는 2048 x 2048픽셀입니다. 이미지 크기는 아래와 같이 size x scale로 계산됩니다.

Google Street View Image API

요청은 Google Maps APIs for Work 라이선스로 구매한 전체 페이지 뷰에 적용됩니다.

최대 이미지 크기는 2048 x 2048픽셀입니다.


Google Static Maps API 이미지는 최대 2048x2048 픽셀까지 요청할 수 있습니다. 정적 지도 요청의 scale 값은 반환되는 픽셀 수에 영향을 미치기 때문에 최대 size 값은 배율 수준마다 다릅니다.

배율 최대 크기 반환
1 2048x2048 2048x2048
2 1024x1024 2048x2048
4 512x512 2048x2048

Google Street View Image API는 scale 매개변수를 지원하지 않습니다.

Google Maps APIs 사용

여러 Google Maps APIs 제품을 사용할 경우 어떤 키나 자격 증명을 사용해야 하나요?

Google Maps APIs를 사용할 때마다 요청을 검증할 자격 증명을 포함해야 합니다. 필요한 자격 증명 유형은 Google Maps APIs for Work 라이선스와 사용되는 API에 따라 달라집니다. 대부분 API는 클라이언트 ID를 사용합니다. 경우에 따라 API 키가 필요하기도 합니다.

  • 클라이언트 ID: Google Maps APIs for Work 고객으로 등록하는 경우 클라이언트 ID가 제공됩니다.

    클라이언트 ID로 API 로드 예시: &client=gme-companyname

  • 디지털 서명: 일반적으로 Google Maps APIs for Work 고객이 클라이언트 ID로 인증할 때 사용합니다. 디지털 서명은 Google이 귀하에게 제공한 암호화 키를 사용하여 생성됩니다.
  • API 키: API 키는 Google API Console을 사용하여 생성되는 고유 식별자입니다. 일반적으로 API 키는 표준 API와 사용됩니다. Google Maps APIs for Work 고객은 대개 클라이언트 ID를 사용하지만 일부 API는 클라이언트 ID 대신 API를 요구하기도 합니다. API 키가 필요한 API의 경우, 제한이 적용되지 않은 API 키(“일반적인 API 키”)를 사용하거나 강화된 보안을 위해 제한이 적용된 키를 사용하도록 선택할 수 있습니다(권장). 모든 플랫폼의 API는 일반적인 API 키를 사용할 수 있습니다.

    API 키에 제한(예: IP 주소)을 추가하고자 할 경우, 한 번 제한을 추가하면 키는 해당 유형의 제한을 지원하는 플랫폼에서만 작동합니다. 네 가지 유형의 API 키 제한을 사용할 수 있습니다.

    • 서버 제한(IP 주소별) - Web Service API에 사용.
    • 브라우저 제한(HTTP 참조 페이지별) - Web API에 사용.
    • Android 앱 제한(패키지 이름 및 지문별) - Android API에 사용.
    • iOS 앱 제한(iOS 번들 식별자별) - iOS API에 사용.

    동일한 플랫폼의 API는 제한된 동일한 키를 사용할 수 있습니다.

    참고: Google API Console에서 키를 생성할 때 Google Maps APIs for Work 사용자는 등록 시 생성한 프로젝트를 선택해야 합니다. 이 프로젝트는 이름에 Business 또는 Work라는 단어를 포함합니다.

    키로 API 로드 예시: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

아래 표는 각 Google Maps APIs 제품에 사용되어야 하는 자격 증명을 나타냅니다. (위에 언급했듯이 API 키 제한의 유형은 서버, 브라우저, Android 및 iOS입니다.)

API Google Maps APIs for Work 사용자
Google Maps Android API Android 제한이 있는 API 키
Google Places API for Android 사용할 수 없음
Google Maps SDK for iOS iOS 제한이 있는 API 키
Google Places API for 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 서버 제한이 있는 API 키
Google Maps Roads API 서버 제한이 있는 API 키
Google Maps Time Zone API 클라이언트 ID + 디지털 서명
Google Places API Web Service 서버 제한이 있는 API 키
HTTPS(SSL)를 통해 로드되는 페이지로부터 Google Maps APIs for Work 클라이언트 ID를 사용하여 Google Maps APIs에 액세스하려면 어떻게 하나요?

HTTPS를 통해 로드되는 페이지로부터 Google Maps APIs에 액세스하려면 API를 사용하려는 HTTPS URL을 먼저 인증해야 합니다.

Common Loader base_domain 매개변수를 사용할 때 HTTPS(SSL)를 통해 Google Maps JavaScript API를 로드하려면 어떻게 하나요?

base_domain 매개변수가 설정된 Common Loader를 사용할 때 SSL을 통해 Maps JavaScript API를 로드하는 것은 불가능합니다.

base_domain 매개변수는 애플리케이션의 성능에 영향을 미치지 않습니다. 어떤 도메인에서 API가 로드되는지에 상관없이, 특정 사용자의 위치에 대한 API 요청은 언제나 최적의 지도 서버에 의해 처리됩니다.

base_domain은 지오코딩 결과를 특정 지역으로 편중시킵니다. base_domain이 없이도 동일한 효과를 얻으려면 지오코딩 서비스의 region 매개변수를 설정하세요.

KML

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

KML 오버레이를 Google Maps JavaScript API에 생성하는 KmlLayer 클래스는 렌더링할 KML 파일을 검색하고 분석하기 위해 Google 호스팅 서비스를 사용합니다. 따라서 공개 액세스가 불가능한 URL에서 호스팅되는 KML 파일이나 액세스 인증이 요구되는 KML 파일은 표시할 수 없습니다.

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

URL 서명

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

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

저의 Google Maps APIs 웹 서비스 요청에 대해 HTTP 403 Forbidden 응답이 수신되는 이유가 무엇인가요?

HTTP 403 응답은 권한 문제를 나타내며, 아마도 이 요청의 서명을 확인할 수 없기 때문일 수 있습니다. 가능한 원인:

  1. 서명이 지정되었지만 이 요청에 올바르지 않습니다.
  2. 이 요청이 Google Maps APIs for Work 클라이언트 ID는 지정하지만 서명은 지정하지 않으며, 호출 중인 웹 서비스의 요구사항에 따르면 클라이언트 ID로 수행된 모든 요청에는 올바른 서명이 포함되어야 합니다.
  3. 서명이 지정되었지만 연결된 Google Maps APIs for Work 클라이언트 ID는 지정되지 않았습니다.

스타일 지정

제 지도에 사업체가 나타나지 않는 이유가 무엇인가요?

Google Maps JavaScript API를 사용하여 지도를 로드할 때 client 매개변수를 포함시키면, 지도상의 사업체 목록이 기본적으로 꺼집니다. 사업체 목록을 켜려면 스타일 지정 코드를 지도에 포함시켜야 합니다.

var styles = [
  {
    featureType: 'poi.business',
    stylers: [
      { visibility: 'on' }
    ]
  }
];

map.setOptions({styles: styles});