Python으로 Google Static Maps API 활용하기: 원하는 위치의 지도 이미지 가져오는 방법

Google은 HTTP 요청에 대해 지도 이미지를 반환하는 Static Maps API를 제공합니다. 이 API를 사용하면 필요에 따라 다양한 파라미터를 조합하여 지도 이미지를 직접 요청할 수 있습니다.

단, 이 API를 사용하려면 먼저 Google에서 결제 계정(Billing Account)을 생성해야 합니다. 자세한 내용은 Google Cloud 공식 웹사이트에서 확인할 수 있습니다.

지도 이미지를 가져오는 단계

requests 모듈을 임포트합니다.
API 키와 기본 URL(https://maps.googleapis.com/maps/api/staticmap?)을 초기화합니다.
가져올 도시 이름과 줌(Zoom) 값을 설정합니다.
API 키, 도시, 줌 값을 URL에 추가합니다.
HTTP 요청을 전송하고, 응답 데이터를 파일에 저장하여 이미지로 저장합니다.

코드 예제

위의 단계를 실제 코드로 구현해 보겠습니다.

# 모듈 임포트
import requests

# 기본 URL
BASE_URL = "https://maps.googleapis.com/maps/api/staticmap?"

# API 키
API_KEY = "Your API Key"

# 도시 이름
CITY = "Hyderabad"

# 줌 값
ZOOM = 14

# URL 업데이트
URL = BASE_URL + "center=" + CITY + "&zoom=" + str(ZOOM) + "&size=500x500&key=" + API_KEY

# HTTP 요청
response = requests.get(URL)

# 응답을 파일(이미지)로 저장
with open('hyderabad.png', 'wb') as file:
    # 파일에 데이터 쓰기
    file.write(response.content)

# 반드시 유효한 API 키를 사용해야 합니다.
# API 키가 유효하지 않으면 상태 코드 403이 반환됩니다.

실행 결과

HTTP 요청이 성공하면 아래와 같은 지도 이미지를 얻을 수 있습니다.

Python으로 Google Static Maps API 활용하기: 원하는 위치의 지도 이미지 가져오는 방법

추가 팁

URL 파라미터를 조정하면 더 다양한 지도 이미지를 얻을 수 있습니다. 예를 들어 size 값을 변경하여 이미지 해상도를 조절하거나, maptype 파라미터를 satellite, terrain, hybrid 등으로 지정하여 다른 스타일의 지도를 받아볼 수 있습니다. 또한 markers 파라미터를 사용하면 특정 위치에 마커를 표시한 이미지도 생성할 수 있습니다.

마무리

이 튜토리얼에 대해 궁금한 점이나 어려운 부분이 있다면 댓글로 남겨주세요. Google Static Maps API를 활용하면 간단한 HTTP 요청만으로 원하는 위치의 지도 이미지를 손쉽게 애플리케이션에 통합할 수 있습니다.