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"
    }
  }
}

텍스트 검색 (신규) 요청

다음 Text Search (New) 요청은 캘리포니아주 마운틴뷰에 있는 매운 채식 레스토랑의 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"
        }
      }
    },
    /.../
  ]
}

Nearby Search (신규) 요청

다음 Nearby Search (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 정책을 참고하세요.