Google Maps Platform Grounding Lite는 Model Context Protocol(MCP)을 지원하는 서비스로, Google 지도의 신뢰할 수 있는 지리공간 데이터로 AI 애플리케이션을 쉽게 그라운딩할 수 있습니다. MCP 서버는 LLM이 장소, 날씨, 경로 기능을 이용할 수 있도록 지원하는 도구를 제공합니다. MCP 서버를 지원하는 도구에서 사용 설정하여 그라운딩 Lite를 사용해 볼 수 있습니다.
도구
그라운딩 Lite는 LLM이 다음 Google 지도 기능에 액세스할 수 있도록 지원하는 도구를 제공합니다.
- 장소 검색: 장소에 관한 정보를 요청하고 AI 생성 장소 데이터 요약과 요약에 포함된 각 장소의 장소 ID, 위도 및 경도 좌표, Google 지도 링크를 가져옵니다. 반환된 장소 ID와 위도 및 경도 좌표를 다른 Google Maps Platform API와 함께 사용하여 지도에 장소를 표시할 수 있습니다.
- 날씨 조회: 날씨에 관한 정보를 요청하고 현재 상태, 시간별 예보, 일별 예보를 반환합니다.
경로 계산: 두 위치 간 운전 또는 도보 경로에 관한 정보를 요청하고 경로 거리 및 시간 정보를 반환합니다.
Maps Grounding Lite MCP 서버를 사용 설정하면 LLM이 서버에서 노출된 새 도구를 호출하여 위에 나열된 데이터 유형에 대한 추가 그라운딩 정보를 반환할 수 있습니다. LLM은 이 추가 정보를 컨텍스트로 사용할 수 있지만 LLM이 궁극적으로 생성하는 대답에는 MCP 서버에서 반환된 정확한 정보가 포함되지 않을 수 있습니다. 생성된 대답의 정확성을 확인해야 합니다.
결제 및 할당량
실험 단계인 동안에는 Grounding Lite를 무료로 사용할 수 있습니다. 하지만 그라운딩 Lite에서 제공하는 도구에는 다음 할당량이 적용됩니다.
- 장소 검색: 프로젝트별 분당 100개의 쿼리 프로젝트당 일일 쿼리 1,000개
- 날씨 조회: 프로젝트별 분당 300개의 쿼리
- 경로 계산: 프로젝트별 분당 300개 쿼리
정책 및 서비스 약관
Grounding Lite에는 이 서비스의 서비스별 약관을 포함한 Google Maps Platform 서비스 약관이 적용됩니다. 이 섹션에서는 호환되는 LLM 및 소스 저작자 표시 요구사항을 비롯한 Grounding Lite의 추가 서비스 사용 요구사항을 설명합니다.
호환되는 LLM 요구사항
Google Maps Platform 서비스 약관을 준수하는 LLM에서만 그라운딩 Lite를 사용할 수 있습니다.
예를 들어 사용하기로 선택한 LLM이 Google 지도 콘텐츠를 캐시하거나 저장하거나 LLM을 개선하는 데 사용하지 않도록 할 책임은 사용자에게 있습니다. Grounding Lite를 사용하기 전에 Grounding Lite와 함께 사용하려는 모델의 서비스 약관을 검토해야 합니다. 모델 학습 또는 개선을 위해 모델에 입력된 데이터를 사용하는 모델과 함께 그라운딩 Lite를 사용해서는 안 됩니다. 모델 사용 시 서비스별 약관을 포함한 Google Maps Platform 서비스 약관의 Google 지도 콘텐츠 제한사항을 완전히 준수해야 합니다.
Google 지도 소스의 저작자 표시 요구사항
Grounding Lite의 각 도구 응답에는 소스가 포함됩니다. Grounding Lite에서 제공하는 도구를 사용하는 결과를 표시할 때는 다음 요구사항을 충족하는 방식으로 연결된 Google 지도 소스를 포함해야 합니다.
- Google 지도 소스는 해당 소스를 뒷받침하는 생성된 콘텐츠 직후에 따라와야 합니다. 이렇게 생성된 콘텐츠를 그라운딩 출력이라고도 합니다.
- Google 지도 소스는 단일 사용자 상호작용 내에서 확인 가능해야 합니다.
장소 검색 도구의 소스
search_places 도구의 places 필드는 summary를 지원하는 소스를 제공합니다. places의 경우 다음 메타데이터가 반환됩니다.
place(리소스 이름)idlocationgoogleMapsLinks
각 장소에 대해 다음 요구사항을 충족하는 링크 미리보기를 생성해야 합니다.
- 각 소스는 Google 지도에서 제공한 것임을 명시하고 그라운딩 Lite 텍스트 저작자 표시 가이드라인을 따라야 합니다.
- 응답에 제공된
googleMapsLinks의 Open Graph 메타데이터og:title에서 소스 페이지 제목을 표시합니다. - 응답에 제공된
places.googleMapsLinks.placeUrl를 사용하여 소스에 연결해야 합니다.
MCP 서버를 사용하도록 LLM 구성
Grounding Lite를 사용하려면 먼저 Maps Grounding Lite API 서비스가 사용 설정된 API 키가 필요합니다. 그런 다음 LLM이 MCP 서버에 액세스하도록 구성할 수 있습니다. 그라운딩 Lite MCP 서버는 스트리밍 가능한 HTTP 전송을 사용합니다.
API 키 만들기 또는 구성
키에서 Maps Grounding Lite API 서비스를 사용 설정하는 한 Maps Grounding Lite에서 기존 API 키를 사용하거나 새 API 키를 만들 수 있습니다. Maps Grounding Lite API는 실험 기간에는 요금이 청구되지 않지만 프로젝트에서 결제가 사용 설정되어 있어야 합니다.
API를 사용 설정하려면 다음 안내를 따르세요.
- Google Cloud 콘솔에서 Grounding Lite에 사용할 프로젝트를 선택합니다.
- Google Cloud 콘솔에서 프로젝트의 결제를 사용 설정합니다.
- 상단 탐색에서 Cloud Shell 터미널을 엽니다.
다음 명령어를 실행하여 서비스와 MCP 엔드포인트를 사용 설정합니다.
gcloud beta services enable mapstools.googleapis.com --project=PROJECT_ID gcloud beta services mcp enable mapstools.googleapis.com --project=PROJECT_IDGoogle Maps Platform 시작하기의 단계에 따라 API 키를 만들거나 구성합니다.
API 키는 X-Goog-Api-Key 헤더를 사용하여 MCP 서버에 전달해야 합니다. LLM의 MCP 도구 구성에서 이를 맞춤 HTTP 헤더로 지정해야 합니다.
그라운딩 Lite MCP 서버에 액세스하도록 LLM 구성
Maps Grounding Lite API 서비스가 사용 설정된 API 키가 있으면 해당 MCP 구성 문서를 따르고 Grounding Lite MCP 서버 URL(https://mapstools.googleapis.com/mcp)을 사용하여 MCP 서버에 액세스하도록 LLM을 구성할 수 있습니다.
Gemini CLI로 그라운딩 Lite 구성
이 섹션에서는 Gemini CLI를 사용하여 그라운딩 Lite MCP 서버를 구성하는 방법을 보여주는 예를 제공합니다. 자세한 내용은 Gemini CLI를 사용하는 MCP 서버를 참고하세요.
Gemini CLI를 설치한 후 add 명령어를 사용하여 Maps Grounding Lite MCP 서버를 구성할 수 있습니다.
gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp구성이 완료되면 서버가 사용자 설정에 추가되었다는 확인 메시지가 표시됩니다.
서버가 올바르게 작동하는지 확인하려면
/mcp list명령어를 실행합니다.> /mcp list Configured MCP servers: maps-grounding-lite-mcp - Ready (3 tools) Tools: - compute_routes - lookup_weather - search_placesCLI를 사용하여 지도 관련 질문을 시작합니다. 예를 들어 '마운틴 뷰에 있는 음식점을 추천해 줘'라고 말하면 사용자를 대신하여 search_places 도구를 호출합니다.
의견 공유
Grounding Lite에 대한 의견을 공유하려면 다음 양식을 사용하세요.