참고 : 이 도움말은 Google 지도가 포함된 트래픽이 많은 삽입된 보고서를 작성하는 사용자를 위한 것입니다. 이 도움말에서 설명하는 작업은 Google Cloud 콘솔을 다루는 데 익숙한 사용자나 이런 숙련자와 작업하는 경우에만 완료할 수 있습니다.
삽입을 사용 설정하면 Looker Studio 보고서에서 매달 최대 30,000회의 무료 Google 지도 로드를 지원합니다. 지도 로드는 PDF 다운로드와 이메일 보기는 물론, 보고서의 삽입된 보기와 미삽입 보기 모두에서 집계됩니다. 보고서가 무료 할당량을 초과할 경우 보고서의 Google 지도에 오류가 표시됩니다.
보고서에 Google 지도 API 키를 추가하여 허용되는 지도 로드 수를 늘릴 수 있습니다.
중요: API 키를 사용하는 보고서에는 더 이상 30,000회의 지도 로드 무료 할당량이 적용되지 않습니다. 각 지도 로드에는 API 키 가격 책정 등급이 반영됩니다.
Google 지도 API 키 만들기
Google 지도 API 키를 만들고 관리하려면 API 키 사용하기 (Google Maps Platform 문서에서 열림)를 참고하세요. 이 단계를 완료하려면 Google Cloud 결제 프로젝트를 설정해야 합니다.
API 키 사용 페이지에서 사용자 인증 정보 페이지로 이동을 클릭합니다.
메시지가 표시되면 청구 프로젝트를 선택합니다.
왼쪽 상단에서 + 사용자 인증 정보 만들기를 클릭합니다.
(선택사항이지만 권장) 키 제한을 클릭합니다.
API 키를 보고서로 제한
Cloud Console에 보고서 URL을 추가하여 API 키를 사용해야 하는 보고서로만 API 키를 제한하는 것이 좋습니다.
애플리케이션 제한사항에서 HTTP 리퍼러 (웹사이트)를 선택합니다.
웹사이트 제한사항에서 항목 추가를 클릭합니다.
이 API 키를 사용할 Looker Studio 보고서의 URL을 입력합니다.
여러 보고서에서 이 키를 사용할 수 있도록 URL을 추가합니다.
와일드 카드를 사용하면 여러 페이지 보고서가 API 키로 작동하도록 할 수 있습니다. 보고서를 삽입하는 경우 보고서의 삽입 URL도 포함해야 합니다.
도움말 : URL에 여러 로그인 부분이 존재한다면 이를 삭제해야 합니다. 예를 들어 URL이 https://lookerstudio.google.com/u/0/reporting/…인 경우 /u/0 부분을 삭제하여 https://lookerstudio.google.com/reporting/…처럼 표시해야 합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-30(UTC)"],[],[],null,["# Add a Google Maps API key\n\n\u003e **NOTE** : This article is for creators of highly trafficked embedded reports that contain Google Maps. To complete the tasks described here, you should be (or work with someone who is) familiar with working in Google Cloud Console.\n\nWhen embedding is enabled, a Looker Studio report supports up to 30,000 free Google Map loads per month. Map loads are counted for both embedded and non-embedded views of the report, as well as for PDF download and email views. If your report exceeds the free quota, Google Maps in the report display an error.\n\nYou can increase the number of map loads allowed by adding a Google Maps API key to the report.\n\n**IMPORTANT:** Reports that use an API key are no longer subject to the free quota of 30,000 map loads. Each map load counts against your API key pricing tier.\n\nCreate a Google Maps API key\n----------------------------\n\nTo create and manage Google Maps API keys, see [Using API Keys](https://developers.google.com/maps/documentation/javascript/get-api-key) (opens in the Google Maps Platform documentation). You'll need to have a Google Cloud [billing project](https://pantheon.corp.google.com/projectselector2/google/maps-apis/credentials?_ga=2.185007785.1036907152.1627424416-1520454904.1626384426) set up to complete this step.\n\n1. On the *Using API Keys* page, click **Go to the Credentials page**.\n2. If prompted, select your billing project.\n3. In the top left, click **+ CREATE CREDENTIALS**.\n4. (Optional but recommended) Click **RESTRICT KEY**.\n\n### Restrict the API key to your reports\n\nWe recommend that you restrict the API key to just the reports that need to use it by adding the report URLs to the Cloud Console.\n\n1. Under *Application restrictions* , select **HTTP referrers (web sites)**.\n2. Under *Website restrictions* , click **Add an item**.\n3. Enter the URL of the Looker Studio report that will use this API key.\n4. Add additional URLs to allow multiple reports to use this key.\n\nYou can use wildcards so that multi page reports will work with your API key. If you are embedding your report, you need to include the embed URL of the report as well.\n\nFor example, to include multiple pages, use a URL like this:\n\n`https://lookerstudio.google.com/reporting/\u003csome-report-id\u003e/*`\n\nTo include an embedded report, use a URL like this:\n\n`https://lookerstudio.google.com/embed/reporting/\u003csome-report-id\u003e/*`\n\u003e **Tip** : You should remove any multi login portions of the URL, if present. For example, if the URL looks like this: `https://lookerstudio.google.com/u/0/reporting/...` then you should remove the `/u/0` portion so that it appears like this: `https://lookerstudio.google.com/reporting/...`\n\nAdd your Google Maps API key to your reports\n--------------------------------------------\n\n1. [Edit your report](/looker/docs/studio/edit-a-report).\n2. Select **File \\\u003e Report settings**.\n3. Enter the API key in the **Google Maps API key** field.\n\nPricing\n-------\n\nYour billing account will be charged for using the API key. The following [pricing tiers](https://cloud.google.com/maps-platform/pricing/) apply:\n\n- Dynamic Maps \\\u003e Maps Javascript API for map loads\n- Dynamic Street View \\\u003e Maps Javascript API for street view usage"]]
