Maps Management API는 클라우드 기반 지도 스타일 지정 리소스를 프로그래매틱 방식으로 관리하는 데 사용할 수 있는 REST API입니다. 이 API를 사용하면 Cloud 콘솔을 사용하지 않고도 지도의 시각적 모양을 정의하고, 지도 ID를 관리하고, 맞춤 스타일과 데이터 세트를 특정 지도 변형과 연결할 수 있습니다.
Map Management API는 지도 구성을 대규모로 관리하거나 지도 스타일을 자체 자동화된 워크플로 및 내부 도구에 통합하려는 개발자를 위해 설계되었습니다.
주요 리소스
- StyleConfig: 지도 스타일의 JSON 표현을 포함합니다. 지도 지형지물의 색상, 가시성, 밀도를 정의합니다.
- MapConfig: 고유한 지도 ID를 나타냅니다. 스타일 설정과 관심 장소 부스팅, 건물 평탄화와 같은 기능의 컨테이너 역할을 합니다.
- MapContextConfig:
MapConfig내에서StyleConfig(선택적으로 하나 이상의 데이터 세트)를 특정MapVariants와 연결합니다.
API 버전 관리 채널
지도 관리 API는 채널 기반 버전 관리를 사용하여 실험용 기능에서 안정적인 정식 버전으로 명확하게 전환할 수 있도록 지원합니다.
- v2alpha (실험용): 최신 실험용 기능이 포함되어 있습니다. 이 채널의 기능은 예고 없이 변경될 수 있으며 프로덕션 용도로는 사용하지 않는 것이 좋습니다.
- v2beta (미리보기): 안정적이며 정식 버전을 위해 준비 중인 기능이 포함되어 있습니다. 이 채널은 사전 프로덕션 환경에서 조기 도입 및 테스트에 적합합니다.
- v2 (정식 버전): 완전히 지원되고 프로덕션 준비가 완료된 기능을 포함합니다.
대부분의 v2 기능은 각 출시 단계에서 v2alpha 및 v2beta 엔드포인트 모두에서 사용할 수 있습니다. 신규 사용자의 경우 v2beta 엔드포인트로 시작하는 것이 좋습니다.
인증
API 키를 지원하지 않는 지도 관리 API로 인증하는 데는 OAuth 2.0만 사용할 수 있습니다. 자세한 내용은 OAuth 사용을 참고하세요.
제한사항
- 개발자 역할: 지도 관리 API를 사용하려면 Google Cloud 프로젝트 내에서 Google Maps Platform 리소스를 관리하는 데 필요한 IAM 권한이 있어야 합니다.
- 리소스 범위: 이 API는 클라우드 기반 지도 스타일 리소스 관리에 중점을 둡니다. 다른 Google Maps Platform 구성에는 여전히 Cloud 콘솔이 필요할 수 있습니다.
비용
Map Management API는 무료로 사용할 수 있습니다. API 호출은 Cloud Console의 결제 페이지에 표시되지만 청구액은 $0입니다. 하지만 요청은 다음과 같이 제한됩니다.
- 3QPS (초당 쿼리 수)
- 프로젝트의 경우 180QPM (분당 쿼리 수), 매분 새로고침
- 프로젝트당 100,000QPD (일일 쿼리 수), 매일 새로고침
사용량 및 결제를 참고하세요.