AI 기반 요약 제공

Geocoding API는 사용자가 목적지를 이해하는 데 도움이 되는 AI 생성 요약을 제공합니다. 이러한 요약은 Destination 객체의 arrivalSummary 필드에 제공됩니다.

이러한 요약은 여행 계획 및 도착 시 사용자를 지원하기 위해 목적지에 관한 고유한 속성을 캡슐화하는 120자 또는 24단어 이하의 짧고 스캔 가능한 텍스트 스니펫입니다.

예를 들면 다음과 같습니다.

• 도미노 피자 뒤편 ⋅ 흰색과 벽돌색 줄무늬가 있는 중층 아파트 건물 ⋅ 입구는 검은색 금속 문 뒤에 있음
• 발코니가 있는 높은 크림색 아파트 건물 ⋅ 입구는 진입로 위의 큰 아치형 다리 아래에 있으며 경비실이 있음

도착 요약은 AI로 생성됩니다. 하지만 이러한 요약은 실험용이며 때때로 부정확한 정보가 포함될 수 있습니다. 사용자는 AI 기반 요약을 정보의 출처로 사용해서는 안 됩니다.

도착 요약 요청

응답에 도착 요약을 반환하려면 destinations.arrivalSummary를 X-Goog-FieldMask 헤더에 포함하세요. 목적지 검색 요청:

curl -X POST -d '{
  "place": "places/ChIJAWLGeHRZwokRV4Dojw9TEHA"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: destinations.arrivalSummary" \
https://geocode.googleapis.com/v4alpha/geocode/destinations

arrival_summary 필드에는 text, flag_content_url, disclosure_text 필드가 포함된 ArrivalSummary 객체가 포함되어 있습니다.

응답은 다음 형식입니다.

{
  "destinations": [
    {
      "arrivalSummary": {
        "text": {
          "text": "Tall red-brick apartment building ⋅ Entrance has a glass front and a grey metal overhang",
          "languageCode": "en"
        },
        "flagContentUrl": "https://www.google.com/local/review/rap/report?postId=...",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    }
  ]
}

AI 기반 요약 표시

앱에 AI 기반 요약을 표시할 때는 필수 공개 텍스트와 요약 관련 문제를 신고할 수 있는 링크를 포함해야 합니다.

공개 텍스트

text 필드의 AI 기반 요약을 표시할 때는 응지답의 ArrivalSummary 객체에 제공된 현지화된 공개 텍스트를 요약 바로 아래의 disclosure_text 필드에 포함해야 합니다. API에서 제공하는 공개 텍스트를 수정하거나 보강해서는 안 됩니다.

문제 신고

각 요약에는 사용자가 요약 콘텐츠 관련 문제를 신고할 수 있는 링크를 제공하는 flag_content_url이 포함되어 있습니다. AI 기반 요약을 표시할 때는 사용자가 이 링크를 통해 요약 관련 문제를 신고할 수 있도록 해야 합니다.

자세한 내용은 Geocoding API 정책을 참고하세요.

목적지 서비스 범위

AI 기반 요약은 다음 대도시 지역의 주거용 목적지에만 사용할 수 있습니다.

미국

• 애틀랜타
• 보스턴
• 시카고
• 댈라스-포트워스
• 휴스턴
• 라스베이거스
• 로스앤젤레스
• 마이애미
• 뉴욕
• 필라델피아
• 샌디에이고
• 샌프란시스코
• 시애틀
• 워싱턴 D.C.

인도

• 벵갈루루
• 첸나이
• 델리 (뉴델리)
• 하이데라바드
• 콜카타
• 뭄바이

의견

이는 Geocoding API의 실험용 기능입니다. geocoding-feedback-channel@google.com 으로 의견을 보내주시면 감사하겠습니다.