이 페이지에서는 Gemini Enterprise Agent Platform에서 Google 지도 기반 그라운딩 기능을 사용하여 지리공간 컨텍스트를 제공함으로써 생성형 AI 애플리케이션을 향상시키는 방법을 설명합니다.
개요
Gemini Enterprise Agent Platform의 Google 지도 기반 그라운딩은 Gemini 모델을 Google 지도의 지리공간 데이터와 연결하는 서비스입니다. Google 지도는 전 세계 수백만 개의 위치 정보(기업, 랜드마크, 관심 지점 포함)에 액세스할 수 있습니다. 이 데이터는 2억 5천만 개 이상의 장소 정보를 제공하여, 모델의 응답을 그라운딩하고, AI 애플리케이션과 에이전트가 지역 데이터와 지리공간 컨텍스트를 제공할 수 있도록 합니다.
또한 그라운딩은 Google 지도, Google 검색, 사용자의 데이터 소스와 동시에 사용 설정할 수도 있습니다.
Google 지도 그라운딩 활용
Google 지도 그라운딩은 다음과 같은 다양한 애플리케이션에서 활용할 수 있습니다.
- 주변 장소에 대한 질문(예: '가장 가까운 이탈리아 에스프레소 매장이 어디야?')에 답할 수 있는 대화형 어시스턴트
- 맞춤형 설명 및 커뮤니티 정보(예: '걸어서 갈 수 있는 거리에 있는 가족 친화적인 식당에 대해 더 알려줄 수 있어?')
- 전기자동차 충전소나 호텔과 같은 특정 위치 주변 지역의 요약
이러한 기능은 부동산, 여행, 모빌리티, 소셜 미디어 앱과 같은 사용 사례에 특히 유용합니다.
지원되는 모델
다음은 Google 지도 기반 그라운딩을 지원하는 모델 목록입니다.
클릭하여 지원되는 모델 펼치기
- Gemini 3 Pro 이미지
- Gemini 3.1 Flash Image
- Gemini 3.5 Flash
- Gemini 3.1 Flash-Lite
- Gemini 3.1 Flash Image
- Gemini 3.1 Pro
- Gemini 3 Flash
- Gemini 3 Pro Image
- Gemini 2.5 Pro
- Gemini 2.5 Flash
- Gemini 2.5 Flash-Lite
- Gemini 2.5 Flash
- Gemini 2.5 Flash-Lite
- Gemini Live API 네이티브 오디오를 사용한 Gemini 2.5 Flash
- Gemini Live API를 사용한 Gemini 2.0 Flash
Gemini 3 Pro 및 Gemini 3 Pro Image는 일일 검색어 5,000개로 제한됩니다.
Gemini 모델에 대한 자세한 내용은 Gemini 모델을 참조하세요.
Google 지도 그라운딩을 사용하여 모델 응답 그라운딩
이 코드 샘플은 Google 지도 그라운딩을 사용해 모델 응답에 실제 근거를 제공하는 방법을 보여줍니다.
검색 결과는 위도와 경도 좌표를 사용하여 특정 지리적 위치에 맞게 맞춤설정할 수 있습니다.
콘솔
Gemini Enterprise 에이전트 플랫폼에서 Google 지도 기반 그라운딩을 사용하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Vertex AI Studio 페이지로 이동합니다.
도구 섹션에서 그라운딩: Google을 클릭합니다. 구성 창이 표시됩니다.
Google 지도를 사용하려면 Google 지도 전환 버튼을 클릭합니다.
적용을 클릭합니다.
입력란에 프롬프트를 입력한 후 제출을 클릭합니다. 이렇게 하면 Google 지도를 기반으로 프롬프트 응답이 그라운딩됩니다.
Python
설치
pip install --upgrade google-genai
자세한 내용은 SDK 참고 문서를 참고하세요.
Vertex AI에서 Gen AI SDK를 사용하도록 환경 변수를 설정합니다.
# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values # with appropriate values for your project. export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT export GOOGLE_CLOUD_LOCATION=global export GOOGLE_GENAI_USE_ENTERPRISE=True
from google import genai
from google.genai.types import (
GenerateContentConfig,
GoogleMaps,
HttpOptions,
Tool,
)
client = genai.Client(http_options=HttpOptions(api_version="v1"))
response = client.models.generate_content(
model="gemini-2.5-flash",
contents="Where can I get the best espresso near me?",
config=GenerateContentConfig(
tools=[
# Use Google Maps Tool
Tool(google_maps=GoogleMaps())
],
tool_config=types.ToolConfig(
retrieval_config = types.RetrievalConfig(
lat_lng = types.LatLng( # Pass geo coordinates for location-aware grounding
latitude=40.7128,
longitude=-74.006
),
language_code = "en_US", # Optional: localize Maps results
),
),
),
)
print(response.text)
# Example response:
# 'Here are some of the top-rated places to get espresso near you: ...'
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- LOCATION: 요청을 처리하는 리전입니다. 전역 엔드포인트를 사용하려면 엔드포인트 이름에서 위치를 제외하고 리소스 위치를 전역으로 구성합니다.
- PROJECT_ID: [프로젝트 ID](/resource-manager/docs/creating-managing-projects#identifiers)입니다. .
- MODEL_ID: 멀티모달 모델의 모델 ID입니다.
- PROMPT: 모델에 전송할 프롬프트
- LATITUDE: 해당 위치의 위도입니다. 예를 들어 위도
37.7749는 샌프란시스코를 나타냅니다. 위도와 경도 좌표는 Google 지도 또는 다른 지오코딩 도구를 사용하여 얻을 수 있습니다. - LONGITUDE: 해당 위치의 경도입니다. 예를 들어 경도
-122.4194는 샌프란시스코를 나타냅니다. - GROUNDING_TYPES: 사용 설정할 Google 지도 그라운딩 유형입니다. 현재
places및routing가 지원됩니다.places: 시설, 주요 관심 장소, 지리적 위치를 비롯한 장소 정보를 검색합니다.routing: 길찾기를 확인하고 경로를 따라 검색합니다. 라우팅은 비공개 미리보기 상태입니다.
places입니다.
HTTP 메서드 및 URL:
POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent
JSON 요청 본문:
{
"contents": [{
"role": "user",
"parts": [{
"text": "PROMPT"
}]
}],
"tools": [{
"googleMaps": {
"groundingTypes": {
"places": {},
"routing": {}
}
}
}],
"toolConfig": {
"retrievalConfig": {
"latLng": {
"latitude": LATITUDE,
"longitude": LONGITUDE
},
"languageCode": "en_US"
}
},
"model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout. It has a rating of 4.2 stars based on 411 reviews."
}
]
},
"finishReason": "STOP",
"groundingMetadata": {
"groundingChunks": [
{
"maps": {
"uri": "https://maps.google.com/?cid=9001322937822692826",
"title": "The Italian Place",
"placeId": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w"
}
},
{
"maps": {
"uri": "https://maps.google.com/?cid=9001322937822692826",
"title": "Hank's Pasta Bar",
"placeId": "places/MMVtPzn9FGcevML89",
"placeAnswerSources": {
"reviewSnippets": [
{
"id": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w",
"title": "Google Maps Review",
"uri": "https://maps.google.com/?cid=9001322937822692826"
},
]
}
}
},
...
],
"groundingSupports": [
{
"segment": {
"endIndex": 79,
"text": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout."
},
"groundingChunkIndices": [
0
]
},
],
}
}
],
...
}
장소 속성
이 섹션에서는 위치를 설명하는 데 사용되고, Google 지도 그라운딩이 응답을 생성할 때 활용되는 장소 속성을 보여줍니다. 이러한 속성은 Google 지도 그라운딩이 어떤 유형의 질문에 답할 수 있는지를 결정하는 데 사용됩니다.
샘플 장소 속성
아래는 모델이 응답을 생성하는 데 사용할 수 있는 장소에 관한 속성을 알파벳순으로 샘플링한 예시입니다.
- 주소
- 매장 밖 수령
- 체크카드
- 거리
- 무료 주차장
- 라이브 음악
- 어린이 메뉴
- 영업시간
- 결제 옵션(예: 현금 또는 신용카드)
- 장소 답변
- 반려동물 동반 가능
- 맥주 제공
- 채식 음식 제공
- 휠체어 이용 가능
- Wi-Fi
장소 답변은 Google 지도 그라운딩이 사용자 리뷰에서 파생된 정보를 기반으로 생성한 응답을 의미합니다.
장소 속성 사용 예시
아래 예시는 다양한 유형의 장소에 대한 질문에서 장소 속성을 어떻게 활용하는지를 보여줍니다. Google 지도 그라운딩은 이러한 속성을 사용해 사용자의 의도를 파악하고, Google 지도에 연계된 장소 데이터를 기반으로 관련 답변을 제공합니다.
가족 저녁 식사 계획하기: 'The Italian Place'는 아이들에게 좋은가요? 테이크아웃도 가능한가요? 평점은 어떻게 되나요?와 같이 물을 수 있습니다.
이러한 질문에 대한 답변은 식당이 가족 외식에 적합한지, 편리한 서비스를 제공하는지를 판단하는 데 도움이 됩니다.
친구의 접근성 확인: 휠체어 이용 가능한 입구가 있는 음식점이 필요합니다.와 같이 물을 수 있습니다.
이 요청에 대한 답변은 해당 장소가 특정 접근성 요구사항을 충족하는지 여부를 확인하는 데 도움이 됩니다.
야식 장소 찾기: 'Burger Joint'가 지금 영업 중인가요? 저녁 식사 가능한가요? 금요일 영업시간은 어떻게 되나요?와 같이 물을 수 있습니다.
이러한 질문에 대한 답변은 특정 시간대에 특정 식사를 제공하는 영업 중인 식당을 찾는 데 도움이 됩니다.
고객과 커피 미팅하기: 'Cafe Central'에 Wi-Fi가 있나요? 커피를 제공하나요? 가격대는 어떤가요? 신용카드를 받나요?와 같이 물을 수 있습니다.
이러한 질문에 대한 답변은 카페의 편의시설, 제공 메뉴, 결제 옵션을 기준으로 비즈니스 미팅 장소로 적합한지 평가하는 데 도움이 됩니다.
Google 지도 그라운딩 결과의 정보는 실제 도로 상황과 다를 수 있습니다.
응답 이해하기
Google 지도 소스는 groundingChunks 내의 groundingMetadata에 포함되어 반환됩니다. 소스는 장소와 사용자 리뷰에 대해 반환되며, 이는 Google 지도 그라운딩 결과를 생성하는 데 사용됩니다.
아래 코드 샘플은 응답에서 장소 소스와 장소 답변 소스가 어떻게 표시되는지를 보여줍니다.
"groundingChunks": [
{
"maps": {
"uri": "{Link to Maps Content}",
"title": "{Name of Maps Place}",
"placeId": "{Place ID}",
"placeAnswerSources": {
"reviewSnippets" : [
{
"reviewId": "{Review ID}",
"googleMapsUri": "{Link to Maps Content}",
"title": "{Title of review}"
}
]
}
},
}
],
라우팅 - 길찾기
Google 지도 기반 그라운딩은 길찾기 기능을 지원합니다. 이 기능을 사용하면 AI 에이전트가 실제 이동, 실시간 이동 예상 시간, 위치 간의 공간적 관계를 이해할 수 있습니다. 경로 찾기 기능을 사용하면 모델이 성능에 최적화된 경로와 실시간 상황을 고려한 정확한 이동 시간을 제공할 수 있습니다. 이 통합을 통해 Google 지도 기반 그라운딩을 사용하면 이동 시간을 기준으로 장소를 필터링하고, 정확한 지점 간 경로를 제공하고, 특정 교통수단의 예상 통근 시간을 계산할 수 있습니다.
길찾기 기능은 제한된 미리보기로 제공됩니다. 프로젝트에서 이 기능에 액세스하려면 Google Cloud 계정팀에 문의하여 허용 목록에 추가해 달라고 요청하세요. 또는 참여 양식을 제출하여 검토를 받을 수 있습니다. Google은 Google 지도 기반 그라운딩의 새로운 기능으로 길찾기를 파일럿으로 운영하기 위해 제한된 파트너 그룹의 관심을 받고 있습니다.
기능
Find Directions는 출발지와 목적지 간의 정확한 이동 거리와 시간을 계산합니다.
길찾기는 다음을 지원합니다.
교통수단: 운전, 도보, 자전거, 대중교통, 전동이륜차 경로 (일부 국가에서는 일부 이동 모드를 사용할 수 없음)
여러 경유지: 출발지와 목적지 사이의 중간 정류장이 최대 13개
실시간 교통정보: 현재 교통 상황을 고려하여 정적 평균이 아닌 정확한 '실시간' 이동 시간을 제공합니다.
다음은 길찾기에서 지원하는 질문 유형의 예입니다.
이동 시간을 기준으로 한 근접성: "뉴욕 1335 6번가에 있는 힐튼 호텔에서 도보로 10분 이내에 있는 미국 레스토랑을 알려 줘."
통근 시간 추정: "시애틀 파이크 플레이스 마켓에서 캐피톨 힐까지 대중교통으로 얼마나 걸려?"
응답 이해
프롬프트가 길찾기 기능을 트리거하면 모델은 구조화된 메타데이터를 기반으로 자연어 대답을 생성합니다. 이를 통해 사용자에게 정확한 여행 정보를 표시할 수 있습니다.
페이로드 응답에 다음 데이터가 반환됩니다.
시간: 위치 간 이동에 필요한 시간입니다. 요청된 경우 교통 상황이 고려됩니다. 예를 들어 '500초'입니다.
거리: 경로의 물리적 거리입니다. 예: '1.9km'
폴리라인: 지도에서 특정 경로를 시각적으로 렌더링할 수 있는 인코딩된 텍스트 문자열입니다.
다음은 '내가 묵고 있는 힐튼 호텔 (뉴욕 6번가 1335번지)에서 카민 레스토랑까지 어떻게 가야 해?'라는 프롬프트에 대한 응답의 예시입니다.
뉴욕시 6번가 1335번지에 있는 힐튼 호텔에서 카민 레스토랑으로 가려면 뉴욕시 44번가 200번지에 있는 카민 - 타임스퀘어 지점(200 W 44th St, New York, NY 10036, USA)으로 가야 합니다.
도보 경로는 다음과 같습니다.
힐튼 호텔에서 시작: 1335 6th Ave에서 힐튼 호텔을 나옵니다.
6번가에서 남쪽으로 걷기: 6번가 (Avenue of the Americas)에서 W 44th Street 방향으로 남쪽으로 향합니다.
W 44번가에서 우회전: W 44번가에서 우회전합니다.
Carmine's는 왼쪽에 있습니다. W 44th Street을 따라 걸어가면 200 W 44th St에 있는 Carmine's가 왼쪽에 있습니다.
이 산책은 약 0.8km이며 10~15분 정도 걸립니다.
다음은 '시애틀의 파이크 플레이스 마켓에서 캐피톨 힐까지 대중교통으로 얼마나 걸려?'라는 프롬프트에 대한 응답의 예입니다.
대중교통을 이용하여 시애틀의 파이크 플레이스 마켓에서 캐피톨 힐로 이동하는 방법에는 다음과 같은 몇 가지 옵션이 있습니다.
트램 (경전철): 피크 플레이스 마켓 근처의 웨스트레이크에서 캐피톨 힐까지 가는 트램은 약 3분이 소요됩니다. 환승을 포함한 총 이동 시간은 약 9분이며, 트램은 10분마다 출발합니다.
버스: 파이크 스트리트와 4번가 (파이크 플레이스 마켓 근처)에서 캐피털 힐까지 가는 킹 카운티 메트로 직행 버스는 약 11분이 소요되며 20분마다 출발합니다. 또는 49번 버스를 타면 약 16분이 소요됩니다.
라우팅 - 경로를 따라 검색
경로 따라 검색을 사용하면 AI 에이전트가 사용자의 계획된 여정과 지리적으로 관련이 있고 편리한 관심분야를 찾을 수 있습니다. Google 지도 경로 및 공간 검색 엔진에서 응답을 그라운딩하면 모델이 우회로를 최소화하고 자동차 여행이나 통근의 물류 흐름을 이해하는 추천을 제공할 수 있습니다.
경로를 따라 검색 기능은 제한된 미리보기로 제공됩니다. 프로젝트에서 이 기능에 액세스하려면 Google Cloud 계정팀에 문의하여 허용 목록에 추가해 달라고 요청하세요. 또는 이 양식을 제출하여 참여를 고려할 수도 있습니다. 현재 Google 지도 경로를 따라 검색으로 그라운딩 도구를 파일럿하기 위해 제한된 파트너 코호트의 관심사만 접수하고 있습니다.
기능
경로 따라 검색을 사용하면 애플리케이션이 출발지와 목적지 사이에서 생성된 경로를 따라 직접 위치한 특정 비즈니스, 편의시설 또는 명소를 식별할 수 있습니다. 미리보기에서는 '자동차' 이동 모드만 지원됩니다.
다음 예는 경로 따라 검색 도구에서 처리할 수 있는 질문 유형을 보여줍니다.
- 기본 경로 검색: '1800 Amphibious Blvd. Mountain View, CA 94045에서 456 Sunny St, Sunnyvale CA로 가는 길에 있는 주유소를 찾아 줘.' (일반적으로 출처 및 대상 주소는 채팅 기록에서 파생됩니다.)
- 장소 속성을 기반으로 검색: '샌프란시스코와 1800 Amphibious Blvd. Mountain View, CA 94045 사이에 별표 평점이 4점 이상인 빵집이 있나요?'
- 여러 구간으로 구성된 경로 검색: '샌프란시스코에서 산루이스오비스포를 거쳐 로스앤젤레스까지 자동차 여행을 떠나려고 하는데, 샌프란시스코와 산루이스오비스포 사이, 그리고 산루이스오비스포와 로스앤젤레스 사이의 EV 충전기 옵션 3곳을 추천해 줘.'
응답 이해
프롬프트가 경로 따라 검색 도구를 트리거하면 모델은 장소와 경로 데이터를 모두 결합한 구조화된 메타데이터를 기반으로 자연어 대답을 생성합니다. 이렇게 하면 추천 위치가 실제 이동 경로에 편리하게 위치합니다. groundingMetadata에는 반환된 장소와 검색된 경로의 groundingChunks가 포함됩니다.
프롬프트 예시[기본 경로 검색]:
1800 Amphibious Blvd. Mountain View, CA 94045에서 456 Sunny St, Sunnyvale CA로 가는 길에 있는 주유소를 찾아 줘.
응답 예시[기본 경로 검색]:
1800 Amphibious Blvd. Mountain View, CA 94045에서 456 Sunny St, Sunnyvale, CA로 가는 길에 있는 주유소는 다음과 같습니다.
- Example 주유소 - 주소는 123 Example Rd, Sunnyvale, CA 94045입니다. 122개의 리뷰에서 별점 3.5를 받았으며 수소, 프로판, 휘발유를 판매하고 세차도 제공합니다. 오늘 밤 9시 50분까지 영업하며 화장실이 있습니다.
- 가상 주유소 - 456 Fictional Ave, Sunnyvale, CA 94045에 위치합니다. 52개의 리뷰에서 별표 평점이 3.6이며 편의점과 세차장을 제공합니다. 이 주유소는 24시간 운영되며 화장실이 있습니다.
- 일반 주유소 - 789 W Generic St, Sunnyvale, CA 94045에 있습니다. 리뷰 35개의 별점은 3.6점입니다. 이 역은 24시간 운영되며 화장실이 있습니다.
프롬프트 예시 [여러 구간 경로 검색]:
샌프란시스코에서 샌루이스오비스포를 거쳐 로스앤젤레스까지 자동차 여행을 떠날 예정이야. 샌프란시스코와 샌루이스오비스포 사이, 그리고 샌루이스오비스포와 로스앤젤레스 사이의 전기차 충전소 옵션 3곳을 추천해 줘.
응답 예시 [여러 구간 경로 검색]:
샌프란시스코에서 로스앤젤레스까지의 자동차 여행 중 샌루이스오비스포에 들를 때 사용할 수 있는 EV 충전기 옵션은 다음과 같습니다.
샌프란시스코와 샌루이스오비스포 사이:
- Example Charger: 123 Example Blvd, Campbell, CA 95008에 위치한 이 충전소의 평점은 4.5입니다.
- 가상 EV 충전소: 이 충전소는 456 Fictional Rd, Gilroy, CA 95008에 있으며 평점은 4.4입니다.
- 일반 충전소: 이 충전소는 789 Generic St, Salinas, CA 95008에 있으며 평점은 3.5입니다.
샌루이스오비스포와 로스앤젤레스 사이:
- 충전기 예: 123 Example Rd, San Luis Obispo, CA 93123에 위치한 이 충전소의 평점은 4.3입니다.
- 가상 EV 충전소: 이 충전소는 456 Fictional Ave, Santa Barbara, CA 93123에 있으며 평점은 3.9입니다.
- 일반 충전소: 이 충전소는 789 Generic St, Glendale, CA 93123에 있으며 평점은 3.0입니다.
즐거운 로드 트립 되세요.
서비스 사용 요구사항
이 섹션에서는 Google 지도 그라운딩에 대한 서비스 사용 요구사항을 설명합니다.
사용자에게 Google 지도 소스 사용 알림
각 Google 지도 그라운딩 결과와 함께 각 응답을 지원하는 groundingChunks의 소스가 수신됩니다. 다음 메타데이터도 반환됩니다.
- 소스 URI
- 제목
- ID
Gemini Enterprise Agent Platform의 Google 지도 기반 그라운딩 결과를 표시할 때는 연결된 Google 지도 소스를 명시하고 사용자에게 다음 사항을 알려야 합니다.
- Google 지도 소스는 해당 소스를 뒷받침하는 생성된 콘텐츠 직후에 따라와야 합니다. 이렇게 생성된 콘텐츠를 Google 지도 그라운딩 결과라고도 합니다.
- Google 지도 소스는 단일 사용자 상호작용 내에서 확인 가능해야 합니다.
음성 우선 인터페이스
출처: Google 지도 출처는 AI 음성 대화의 완전한 이전 기록을 보여주는 동반 UI에 표시해야 합니다. 이 기록은 출처 요구사항을 준수해야 하며 관련 데이터 캐싱 및 저장소 제한이 적용됩니다.
소스의 적극적인 공개: 최종 사용자는 상호작용 시 Google 지도가 자신의 환경에서 어떤 역할을 하는지, 자세한 소스를 찾는 방법을 합리적으로 인지해야 합니다.
소스의 적극적인 공개에는 다음 사항이 전달되어야 합니다.
AI 생성 콘텐츠에는 Google 지도의 정보가 포함될 수 있습니다.
자세한 소스는 컴패니언 UI에서 확인할 수 있습니다.
다음 방법 중 하나 이상을 사용하여 소스의 적극적인 공개를 전달해야 합니다.
시각적 표시: 화면이 있는 기기에서 발생하는 음성 상호작용의 경우 Google 지도와의 그라운딩이 사용될 때마다 화면에 활성 공개를 표시합니다.
음성 안내: 사용자에게 활성 공개 정보를 읽어줍니다. 이는 Google 지도 기반 그라운딩이 지원하는 첫 번째 상호작용 중에 발생해야 하며 최소 6개월마다 반복되어야 합니다.
공개 예시: 'AI 생성 콘텐츠에는 Google 지도의 정보가 포함될 수 있습니다. 자세한 출처는 동반 앱에서 확인하세요.'
지속적인 공개: Google 지도 콘텐츠가 AI 생성 콘텐츠에 사용될 수 있다는 설명은 최종 사용자가 지속적으로 액세스할 수 있어야 합니다 (예: 음성 설정 메뉴 또는 음성 상호작용 공개).
사용자 문의: 음성 어시스턴트는 AI 생성 콘텐츠에 Google 지도 정보가 포함된 경우를 비롯해 콘텐츠 소스에 관한 최종 사용자 문의에 정확하게 답변해야 합니다. Google 지도가 소스인 경우 최종 사용자를 특정 소스 정보에 액세스할 수 있는 동반 UI로 안내하세요.
Google 지도 소스를 Google 지도 링크와 함께 표시
groundingChunks와 grounding_chunks.maps.placeAnswerSources.reviewSnippets 내의 각 소스에 대해 다음 요구사항에 따라 링크 미리보기를 생성해야 합니다.
- 각 소스는 Google 지도에서 제공한 것임을 명시하고 Google 지도의 텍스트 저작자 표시 지침을 따라야 합니다.
- 응답에 포함된 소스 제목을 표시해야 합니다.
- 응답에 제공된
uri또는googleMapsUri를 사용하여 소스에 연결해야 합니다.
아래 이미지는 소스와 그 Google 지도 링크를 표시하기 위한 최소 요구사항을 보여줍니다.
또한 소스 보기 영역은 접을 수 있습니다.
선택사항: 링크 미리보기를 다음과 같은 추가 콘텐츠로 보강할 수 있습니다.
- Google 지도 텍스트 저작자 표시 앞에 Google 지도 파비콘을 삽입합니다.
- 소스 URL에서 제공되는 사진(예:
og:image)을 표시합니다.
일부 Google 지도 데이터 제공업체 및 해당 라이선스 조건에 대한 자세한 내용은 Google 지도 및 Google 어스 법적 고지를 참조하세요.
Google 지도 텍스트 저작자 표시 가이드라인
Google 지도의 텍스트 저작자 소스를 표시할 때는 다음 가이드라인을 따라야 합니다.
- Google 지도 텍스트를 어떤 방식으로도 수정하지 마세요.
- Google 지도의 대소문자를 변경하지 마세요.
- Google 지도를 여러 줄로 나누어 표시하지 마세요.
- Google 지도를 다른 언어로 현지화하지 마세요.
- 브라우저가 Google 지도를 번역하지 못하도록 HTML 속성
translate="no"를 사용해야 합니다.
- 다음 표에 설명된 대로 Google 지도 텍스트 스타일을 지정해야 합니다.
| 속성 | 스타일 |
|---|---|
| 글꼴 모음 | Roboto. 글꼴 로드는 선택사항입니다. |
| 대체 글꼴 모음 | 제품에서 이미 사용 중인 sans serif 본문 글꼴 또는 'Sans-Serif'를 지정해 기본 시스템 글꼴을 호출합니다. |
| 글꼴 스타일 | 보통 |
| 글꼴 두께 | 400 |
| 글꼴 색상 | 흰색, 검정(#1F1F1F) 또는 회색(#5E5E5E). 배경 대비를 고려해 접근성 비율(4.5:1)을 유지해야 합니다. |
| 글꼴 크기 | 최소 글꼴 크기: 12sp 최대 글꼴 크기: 16sp sp에 대해 자세히 알아보려면 Material Design 웹사이트의 글꼴 크기 단위를 참조하세요. |
| 문자 간격 | 보통 |
예시 CSS
다음 CSS는 흰색 또는 밝은 배경에서 Google 지도 텍스트를 적절한 타이포그래픽 스타일과 색상으로 렌더링합니다.
@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');
.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}
장소 ID 및 리뷰 ID
Google 지도 데이터에는 장소 ID와 리뷰 ID가 포함됩니다. 다음 응답 데이터를 캐시, 저장, 내보내기할 수 있습니다.
placeIdreviewId
Google 지도 그라운딩 약관에 명시된 캐싱 제한사항은 적용되지 않습니다.
금지된 지역
Google 지도 그라운딩은 안전하고 신뢰할 수 있는 플랫폼을 유지하기 위해 특정 콘텐츠 및 활동에 제한을 둡니다. 고객은 '금지 지역'에서 'Google 지도 기반 그라운딩'을 제공하는 '고객 애플리케이션'을 배포하거나 마케팅할 수 없습니다. 자세한 내용은 Google Maps Platform 금지 지역을 참고하세요. 금지된 지역 목록은 경우에 따라 업데이트될 수 있습니다.
다음 단계
- Gemini 모델을 자체 데이터에 그라운딩하는 방법은 데이터로 그라운딩을 참조하세요.
- 책임감 있는 AI 권장사항 및 Gemini Enterprise Agent Platform의 안전 필터에 대해 자세히 알아보려면 책임감 있는 AI를 참고하세요.