Map Management API는 클라우드 기반 지도 스타일 지정 리소스를 프로그래매틱 방식으로 관리하는 데 사용할 수 있는 RESTful API입니다. 이 API를 사용하면 Cloud 콘솔을 사용하지 않고도 지도의 시각적 모양을 정의하고, 지도 ID를 관리하고, 맞춤 스타일과 데이터 세트를 특정 지도 변형과 연결할 수 있습니다.
Map Management API는 지도 구성을 대규모로 관리하거나 지도 스타일 지정을 자체 자동화 워크플로 및 내부 도구에 통합하려는 개발자를 위해 설계되었습니다.
주요 리소스
- StyleConfig: 지도 스타일의 JSON 표현을 포함합니다. 이렇게 하면 지도 지형지물의 색상, 공개 상태, 밀도가 정의됩니다.
- MapConfig: 고유한 지도 ID를 나타냅니다. 스타일 지정 설정과 관심 장소 부스팅 또는 건물 평면화와 같은 기능의 컨테이너 역할을 합니다.
- MapContextConfig:
StyleConfig(및 선택적으로 하나 이상의 데이터 세트)를MapConfig내의 특정MapVariants와 연결합니다.
API 버전 관리 채널
Map Management 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 콘솔의 결제 페이지에 표시되지만 요금은 $0입니다. 그러나 요청은 다음과 같이 제한됩니다.
- 3QPS (초당 쿼리 수)
- 프로젝트당 180QPM (분당 쿼리 수), 분당 새로고침
- 프로젝트당 100,000QPD (일일 쿼리 수), 매일 새로고침됨
사용량 및 결제를 참고하세요.