AI 기반 장소 요약

AI 기반 장소 요약은 특정 장소 ID에 대한 100자(영문 기준) 분량의 간략한 개요입니다. 장소 요약은 다양한 유형의 데이터를 상위 수준의 개요로 집계하여 사용자가 장소의 개요를 파악하는 데 도움을 줍니다.

예를 들어 장소 요약은 특정 위치에서 구매할 수 있는 인기 음식, 서비스 또는 상품을 강조할 수 있습니다.

  • "캐주얼한 공간에서 푸짐한 전통 이탈리아 요리를 선보이는 포럼 숍스 식당입니다."
  • "커트, 염색, 드라이를 제공하는 세련된 미용실입니다."
  • "다양한 빈티지 장식품, 가구, 의류를 판매하는 여러 가판대가 있는 대형 매장입니다."

장소 요약은 장소 세부정보 (신규), 텍스트 검색 (신규), 주변 지역 검색 (신규)에서 지원됩니다. 장소 요약은 문화, 엔터테인먼트 및 레크리에이션, 음식 및 음료, 쇼핑, 서비스, 스포츠 카테고리의 지원되는 유형에 표시된 장소 유형에 사용할 수 있습니다.

장소 요약은 다음 언어 및 지역의 관심 지점에 대해 지원됩니다.

언어 리전
영어

오스트레일리아

캐나다

인도

뉴질랜드

싱가포르

미국

생성형 장소 요약 요청

응답에 장소 요약을 반환하려면 요청의 필드 마스크에 다음 필드를 포함합니다.

  • 장소 세부정보 (신규): generativeSummary
  • 텍스트 검색 (신규) 및 주변 지역 검색 (신규): places.generativeSummary

generativeSummary 필드에는 다음 필드가 포함됩니다.

  • generativeSummary: 장소 요약입니다.
  • overviewFlagContentUri: 사용자가 장소 요약의 문제를 신고할 수 있는 링크입니다.
  • disclosureText: 출처 표시에 포함해야 하는 공개 문구 'Gemini로 요약됨'이 포함된 현지화된 텍스트 문자열입니다.

장소 세부정보 (신규) 요청

다음 장소 세부정보 (신규) 요청은 일리노이주 시카고에 있는 초밥 전문점의 overview 요약을 반환합니다.

curl -X GET https://places.googleapis.com/v1/places/ChIJ1eOF7HLTD4gRry3xPjk8DkU \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,generativeSummary"

응답은 다음 형식입니다.

{
  "displayName": {
    "text": "Sushi Nova - Lincoln Park",
    "languageCode": "en"
  },
  "generativeSummary": {
    "overview": {
      "text": "Casual eatery with all-you-can-eat sushi and other Japanese fare, plus beer and sake.",
      "languageCode": "en-US"
    },
    "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDg4MGZkMzcyZWM4NWUzZDU6MHg0NTBlM2MzOTNlZjEyZGFmMAI&d=17924085&t=12",
    "disclaimerText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

텍스트 검색 (신규) 요청

다음 텍스트 검색 (신규) 요청은 캘리포니아주 마운틴뷰에 있는 매운 채식 레스토랑에 대한 overview 요약을 반환합니다.

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias": {
    "rectangle": {
      "low": {
        "latitude": 37.415,
        "longitude": -122.091
      },
      "high": {
        "latitude": 37.429,
        "longitude": -122.065
      }
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchText'

응답은 다음 형식입니다.

{
  "places": [
    {
      "id": "ChIJ8wN5kzm3j4AR_dRdUHoqrPI",
      "displayName": {
        "text": "Plant-Based Vegan Vietnamese",
        "languageCode": "en"
      }
    },
    {
      "id": "ChIJw4RuczO3j4ARC7RByZ5K9nI",
      "displayName": {
        "text": "sweetgreen",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering healthy, made-to-order salads, plates, and grain bowls with vegan options.",
          "languageCode": "en-US"
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzMzNzM2ZTg0YzM6MHg3MmY2NGE5ZWM5NDFiNDBiMAI&d=17924085&t=12",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

주변 지역 검색 (New) 요청

다음 주변 지역 검색 (New) 요청은 오리건주 포틀랜드에 있는 식당과 카페의 overview 요약을 반환합니다.

curl -X POST -d '{
  "maxResultCount": 5,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 45.553360,
        "longitude": -122.674934
        },
      "radius": 1000
    }
  },
  "includedTypes": ["restaurant", "cafe"],
  "excludedTypes": [],
  "rankPreference":"POPULARITY"
  }' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchNearby'

응답은 다음 형식입니다.

{
  "places": [
    {
      "id": "ChIJOa08KlqnlVQR_ZZx1jEcTYY",
      "generativeSummary": {
        "overview": {
          "text": "BBQ and Thai street fare, plus imaginative tropical cocktails, served in a vibrant space.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJU4OzoWynlVQRxlQMpGenSvA",
      "generativeSummary": {
        "overview": {
          "text": "Beer hall with a big selection of German brews, plus a central courtyard with food trucks.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

기여 분석

앱에 표시되는 모든 AI 기반 요약에는 Google의 정책 및 표준에 따라 적절한 저작자 표시가 수반되어야 합니다. 자세한 내용은 Places API 정책을 참고하세요.