모든 준비를 마쳤습니다!

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

Google Maps JavaScript API 활성화

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

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

Get a Key/Authentication

All Google Maps JavaScript API applications require authentication.

  • Standard API users: If you're using the API under the standard plan, you must use an API key set up in a project of your choice. See more about API keys for the standard API.
  • 프리미엄 플랜 users: If you're using the API under the Google Maps API 프리미엄 플랜 you have two authentication options:
    • Use an API key set up in the Google Maps API 프리미엄 플랜 project created for you when you purchased the 프리미엄 플랜.
        or
    • Use your client ID instead of an API key.

    See the Google Maps API 프리미엄 플랜 section below for information on choosing the best authentication method.

Authentication for the standard API — API keys

To use the standard API, you must include an API key when loading the API.

Benefits of using an API key:

  • The API key allows you to monitor your application's API usage in the Google API Console. See Google API Console help for more information.
  • With a key, you have access to generous free daily quota, as well as the option increase your daily quota by enabling pay-as-you-go billing.
  • Registering for an API key ensures that Google can contact you about your application if necessary.

Get an API key

To get started using the Google Maps JavaScript API, click the button below, which guides you through the process of activating the Google Maps JavaScript API and any related services automatically.

Get a Key

Alternatively, follow these steps to get an API key:

  1. Go to the Google API Console.
  2. Create or select a project.
  3. Click Continue to enable the API and any related services.
  4. On the Credentials page, get an API key (and set the API key restrictions).
    Note: If you have an existing unrestricted API key, or a key with browser restrictions, you may use that key.
  5. To prevent quota theft, secure your API key following these best practices.
  6. (Optional) Enable billing. See Usage Limits for more information.


In the Google API Console, you can also look up an existing key or view a list of enabled APIs.

For more information on using the Google API Console, see API Console Help.

Types of API key restrictions

Google Maps APIs are available for Android or iOS apps, Web browsers, and via HTTP web services. APIs in any platform can use a generic (unrestricted) API key. You can optionally add a restriction (for example, HTTP referrer) to the API key. Once restricted, a key will only work on platforms that support that type of restriction. Learn more about keys and credentials.

Specify a key when loading the API

To specify a key, include it as the value of a key parameter when loading the API.

For example:

  <script async defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
  type="text/javascript"></script>

Authentication for Google Maps API 프리미엄 플랜 customers

The information in this section applies only to the new Google Maps API 프리미엄 플랜, which became available on January 6, 2016.

이전 Maps APIs for Work 또는 Maps API for Business 라이선스가 있나요? Maps APIs for Work 라이선스 가이드를 참조하세요. 이전 라이선스가 있는지 여부를 판별하려면: Google Cloud Support Portal에서 왼쪽의 Maps: Usage Report를 클릭합니다. 보고서 상단의 ID가 다음 형식이면, 새 프리미엄 플랜가 있는 것입니다:
gme-[company] & proj-[number] ([type])
그렇지 않으면 이전 라이선스가 있는 것입니다.

When using the Google Maps JavaScript API with a Google Maps API 프리미엄 플랜 license, you must authenticate your application with either an API key or a client ID. Note: If you have a previous Maps API for Business license, you must use a client ID, not an API key.

When deciding on which authentication method to use, consider the following:

  • API key (available to Google Maps API 프리미엄 플랜 customers but not to holders of a previous Maps API for Business license) — By using an API key to authenticate requests, you can:
  • Client ID — By using your client ID (instead of an API key) to authenticate requests, you can:
    • Add the channel parameter to requests so you can view more detailed usage reports
    • View usage reports with more than 30 days of data in the Google Cloud Support Portal
    • Use Maps Analytics tools for the Maps JavaScript API

Get more information on reports available to 프리미엄 플랜 customers.

Using an API key

To authenticate the Google Maps JavaScript API using an API key, click the button below which guides you through the process of getting an API key.

Important: In the project drop-down menu, be sure to select the project created for you when you purchased the 프리미엄 플랜. The project name starts with Google Maps APIs for Business 또는 Google Maps for Work 또는 Google Maps.*

Get a Key

Alternatively, follow these steps to get an API key:

  1. Go to the Google API Console.
  2. From the Project drop-down menu, select the Google Maps Premium project.*
  3. Click Continue.
  4. On the Credentials page, get an API key (and set the API key restrictions).
    Note: If you have an existing unrestricted API key, or a key with browser restrictions, you may use that key.
  5. To prevent quota theft, secure your API key following these best practices.

* Note: In the project drop-down menu, you must select the project created for you when you purchased the 프리미엄 플랜. The project name starts with Google Maps APIs for Business 또는 Google Maps for Work 또는 Google Maps. Important: If you have a previous Maps API for Business license, you must use a client ID, not an API key.


You can also look up an existing key in the Google API Console.

For more information on using the Google API Console, see API Console Help.

Specify a key when loading the API

To specify a key, include it as the value of a key parameter when loading the API.

For example:

  <script async defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
  type="text/javascript"></script>

Using a client ID

Authentication of the Google Maps JavaScript API using a client ID (instead of an API key) requires a unique client ID in combination with URL registration.

If you were previously using an API key for authentication and are switching to using a client ID, you must remove the key parameter before loading the API. The API will fail to load if both a client ID and an API key are included.

Your client ID

Upon purchasing your Google Maps API 프리미엄 플랜 license, you will receive a welcome email from Google that contains your client ID. Your client ID is used to access the special features of Google Maps API 프리미엄 플랜. All client IDs begin with a gme- prefix.

This client ID is not a key. It will only work from URLs which you authorize, so you don't need to worry about keeping it secret.

Specify a client ID when loading the API

Specify your client ID as the value of a client parameter when loading the Google Maps JavaScript API:

<script async defer src="https://maps.googleapis.com/maps/api/js?client=YOUR_CLIENT_ID &v=3.26&callback=initMap"></script>

As shown in the above example, you must specify the release version (also referred to as the feature-stable version) or an earlier version, by appending a v=3.26 parameter. Applications that use the experimental version are not covered under the Google Maps API 프리미엄 플랜 SLA.

Registering authorized URLs

타사가 자사 웹사이트에서 여러분의 클라이언트 ID를 사용하는 것을 막기 위해, 이 클라이언트 ID 사용은 여러분이 구체적으로 인증한 URL 목록으로 제한됩니다.

이미 인증했거나 추가로 인증할 URL을 확인하려면:

  1. Google Cloud Support Portal에 로그인합니다.
  2. 왼쪽 메뉴에서 Maps: Manage Client ID를 클릭합니다.

한 번에 최대 100개까지 총 3000개의 URL을 추가할 수 있습니다. 한도를 늘려야 하는 경우 지원에 문의하세요.

URL을 인증할 경우 다음 사항을 고려해야 합니다.

도메인 이름이나 IP 주소는 공개 액세스가 아니어도 됩니다.
예를 들어, http://myintranethttp://192.168.1.1은 올바른 입력입니다.
지정된 도메인의 모든 하위 도메인도 인증됩니다.
예를 들어, http://example.com이 인증되면 http://www.example.com도 인증됩니다. 반대로, http://www.example.com이 인증되더라도 http://example.com이 반드시 인증되는 것은 아닙니다.
인증된 경로의 모든 하위 경로도 인증됩니다.
예를 들어, http://example.com이 인증되면 http://example.com/foo도 인증됩니다. 또한 지정된 도메인의 하위 도메인도 인증되므로 http://sub.example.com/bar가 인증됩니다.
경로는 대/소문자를 구분합니다.
예를 들어, http://www.example.com/ThisPath/http://www.example.com/thispath/와 다릅니다.
특정 포트를 사용하도록 유효한 URL을 제한할 수도 있습니다.
예를 들어, http://example.com:8080/foo가 지정되더라도 http://example.com이 인증되는 것은 아닙니다.
HTTP 및 HTTPS 프로토콜은 다른 URL로 간주됩니다.
예를 들어, https://example.com이 인증되더라도 http://example.com이 반드시 인증되는 것은 아닙니다. 둘 다 인증하려면, 프로토콜을 사용하지 않고 도메인을 추가하면 됩니다: example.com/

위의 모든 규칙은 각 인증에 적용되므로, 인증을 세심하게 계획해야 합니다. 예를 들어, 지정된 경로의 모든 하위 경로와 모든 하위 도메인이 인증되므로, 의도하지 않았던 페이지가 인증될 수도 있습니다. 예:

http://example.com/http://sub.example.com/path도 인증합니다.

자세한 정보는 Google Maps API 프리미엄 플랜 인증 문제 해결을 참조하세요.

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

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