Geocoding API는 사용자가 목적지를 이해하는 데 도움이 되는 AI 생성 요약을 제공합니다. 이러한 요약은 arrival_summary 필드의 Destination 객체에 제공됩니다.
이러한 요약은 여행 계획 및 도착 시 사용자를 지원하기 위해 목적지의 고유한 속성을 캡슐화하는 120자 또는 24단어 이하의 짧고 스캔 가능한 텍스트 스니펫입니다.
예를 들면 다음과 같습니다.
- '도미노 피자 뒤편 ⋅ 흰색과 벽돌색 줄무늬가 있는 중층 아파트 건물 ⋅ 검은색 금속 문 뒤에 입구가 있음'
- '발코니가 있는 높은 크림색 아파트 건물 ⋅ 진입로 위의 큰 아치형 다리 아래에 입구가 있으며 보안 부스가 있음'
도착 요약은 AI로 생성됩니다. 하지만 이러한 요약은 실험 단계에 있으며 때때로 부정확한 정보가 포함될 수 있습니다. 사용자는 AI 기반 요약을 정보의 출처로 사용해서는 안 됩니다.
도착 요약 요청
응답에 도착 요약을 반환하려면 목적지 검색 요청의 X-Goog-FieldMask 헤더에 destinations.arrival_summary를 포함하세요.
arrival_summary 필드에는 text, flag_content_url, disclosure_text 필드가 있는 ArrivalSummary 객체가 포함됩니다.
응답은 다음 형식입니다.
{ "destinations": [ { "arrival_summary": { "text": { "text": "Behind Domino's Pizza ⋅ Mid-rise apartment building with white and brick-red stripes ⋅ Entrance is behind a black metal gate", "languageCode": "en-US" }, "flag_content_url": "https://www.google.com/local/review/rap/report?postId=...", "disclosure_text": { "text": "Summarized with Gemini", "languageCode": "en-US" } } } ] }
AI 기반 요약 표시
앱에 AI 기반 요약을 표시할 때는 필수 공개 텍스트와 요약 관련 문제를 신고할 수 있는 링크를 포함해야 합니다.
공개 텍스트
text 필드의 AI 기반 요약을 표시할 때는 응답의 ArrivalSummary 객체에 있는 disclosure_text 필드에 제공된 현지화된 공개 텍스트를 요약 바로 아래에 포함해야 합니다. API에서 제공하는 공개 텍스트를 수정하거나 보강해서는 안 됩니다.
문제 신고
각 요약에는 사용자가 요약 콘텐츠의 문제를 신고할 수 있는 링크를 제공하는 flag_content_url가 포함되어 있습니다. AI 기반 요약을 표시할 때는 사용자가 요약의 문제를 신고할 수 있도록 이 링크를 제공해야 합니다.
자세한 내용은 Geocoding API 정책을 참고하세요.
대상 범위
AI 기반 요약은 다음 대도시 지역의 주거용 목적지에만 제공됩니다.
미국
- 애틀랜타
- 보스턴
- 시카고
- 댈라스-포트워스
- 휴스턴
- 라스베이거스
- 로스앤젤레스
- 마이애미
- 뉴욕
- 필라델피아
- San Diego
- 샌프란시스코
- 시애틀
- 워싱턴 D.C.
인도
- 방갈로르 (벵갈루루)
- 첸나이
- 델리 (뉴델리)
- 하이데라바드
- 콜카타
- 뭄바이