구글 지도 API, 5분 만에 웹사이트에 붙이는 방법

2026-07-23 · 테크 · 읽는데 7분

구글 지도 API, 웹사이트에 붙이는 데 5분이면 충분합니다

Google Maps JavaScript API를 웹사이트에 추가하는 일은 생각보다 훨씬 간단합니다. API 키 하나만 발급받고, HTML 파일에 코드 몇 줄만 넣으면 바로 지도가 나타납니다. 이 글에서는 실제로 따라 하기 어려운 부분 없이, API 키 생성부터 웹페이지에 지도를 표시하는 전 과정을 순서대로 설명해 드리겠습니다.


API 키를 먼저 만들어야 하는 이유

구글 지도 API는 유료 서비스지만, 매달 200달러 상당의 무료 크레딧이 제공됩니다. 소규모 웹사이트나 개인 프로젝트라면 비용 부담 없이 사용할 수 있는 수준입니다. API를 사용하려면 반드시 Google Cloud 프로젝트를 만들고, 해당 프로젝트에서 결제를 활성화한 뒤 API 키를 발급받아야 합니다.

준비물 - Google 계정 (Gmail 등) - 신용카드 (결제 등록용, 무료 크레딧 범위 내에서는 요금이 청구되지 않습니다)


API 키를 발급받는 4단계

1단계: Google Cloud Console 접속 Google Cloud Console에 로그인한 뒤, 상단의 프로젝트 선택 메뉴에서 새 프로젝트 만들기를 클릭합니다. 프로젝트 이름은 원하는 대로 정하시면 됩니다.

2단계: Maps JavaScript API 사용 설정 좌측 메뉴에서 APIs & Services > Library로 이동합니다. 검색창에 Maps JavaScript API를 입력하고, 해당 API를 찾아 Enable 버튼을 누릅니다.

3단계: API 키 생성 다시 APIs & Services > Credentials로 이동합니다. Create Credentials 버튼을 클릭하고 API key를 선택합니다. 그러면 긴 문자열의 API 키가 생성됩니다. 이 키는 반드시 안전하게 보관하세요.

4단계: API 키 제한 설정 (보안 강화) 생성된 API 키의 Edit API key 화면에서 API restrictions 항목을 찾아 Restrict key를 선택합니다. 그다음 드롭다운 메뉴에서 Maps JavaScript API만 체크하고 저장합니다. 이렇게 하면 다른 API에서 이 키를 사용하는 것을 막을 수 있습니다.

참고: API 키를 제한하지 않고 그대로 사용하면, 다른 사람이 키를 탈취해 악용할 경우 예상치 못한 비용이 발생할 수 있습니다. 반드시 제한을 설정하는 습관을 들이세요.


실제로 웹페이지에 지도 넣기

API 키를 발급받았다면 이제 본격적으로 지도를 웹사이트에 표시해 보겠습니다. 아래 코드는 가장 기본적인 형태입니다. 이 코드를 그대로 복사해 index.html 파일로 저장하고, YOUR_API_KEY 부분을 방금 발급받은 키로 바꾸면 됩니다.

<!DOCTYPE html>
<html>
  <head>
    <title>간단한 구글 지도</title>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap" async defer></script>
    <style>
      #map { height: 400px; width: 100%; }
    </style>
  </head>
  <body>
    <h3>내 웹사이트에 표시된 지도</h3>
    <div id="map"></div>
    <script>
      function initMap() {
        var seoul = { lat: 37.5665, lng: 126.9780 };
        var map = new google.maps.Map(document.getElementById('map'), {
          zoom: 12,
          center: seoul
        });
        var marker = new google.maps.Marker({
          position: seoul,
          map: map
        });
      }
    </script>
  </body>
</html>

코드 설명 - <script> 태그 안 src 주소에 YOUR_API_KEY를 넣습니다. callback=initMap은 지도가 준비되면 자동으로 initMap 함수를 실행하라는 의미입니다. - #map은 지도가 표시될 영역입니다. 높이를 반드시 지정해야 지도가 보입니다. - initMap() 함수 안에서 지도의 중심 좌표(서울 시청)와 줌 레벨을 설정합니다. - new google.maps.Marker()로 지도 위에 마커(핀)를 추가했습니다.

브라우저에서 이 HTML 파일을 열면 서울을 중심으로 한 지도와 마커 하나가 나타납니다.


자주 묻는 질문

Q. API 키를 발급받았는데 지도가 안 보여요. 왜 그런가요?

가장 흔한 원인은 결제 계정이 활성화되지 않았거나, API 키 제한이 잘못 설정된 경우입니다. Google Cloud Console에서 Billing 메뉴에 신용카드가 등록되어 있는지 확인하세요. 또 JavaScript API가 활성화되어 있는지, API 키 제한에 Maps JavaScript API가 포함되어 있는지 다시 점검해 보세요.

Q. 무료 크레딧 200달러는 어떻게 적용되나요?

Google Maps Platform은 매월 200달러의 크레딧을 제공합니다. 예를 들어 Dynamic Maps(동적 지도)의 경우 1,000회 호출당 약 7달러 정도이므로, 200달러 크레딧 안에서 상당히 많은 양을 무료로 사용할 수 있습니다. 단, 2025년 3월 이후 가격 정책이 업데이트되어 SKU별 무료 사용량이 별도로 책정되었으니, 공식 가격 페이지를 참고하는 것이 좋습니다.

Q. 지도 스타일을 바꾸고 싶은데 가능한가요?

가능합니다. google.maps.Map 생성자에 styles 옵션을 추가하면 도로 색, 건물 색, 수역의 색 등을 원하는 대로 변경할 수 있습니다. 예를 들어 어두운 테마의 지도를 만들려면 미리 정의된 스타일 배열을 적용하면 됩니다. Google Cloud Console의 Map Styles 메뉴에서 시각적으로 편집할 수도 있습니다.


마무리하며

이제 여러분의 웹사이트에도 구글 지도를 쉽게 붙일 수 있습니다. API 키 하나 만들고, HTML 파일에 코드 몇 줄 추가하는 것이 전부입니다. 더 나아가 여러 개의 마커를 추가하거나, 사용자 위치를 가져오거나, 길찾기 기능을 넣는 것도 같은 API 안에서 가능합니다. 공식 문서와 샘플 코드 모음이 잘 정리되어 있으니, 필요한 기능이 있다면 Google Maps Platform 문서를 참고해 보세요.