AI 기반 장소 요약은 특정 장소 ID에 특화된 간략한 100자 개요입니다. 장소 요약은 다양한 유형의 데이터를 상위 수준 개요로 집계하여 사용자가 장소를 한눈에 파악할 수 있도록 지원합니다.
예를 들어 장소 요약은 특정 위치에서 구매할 수 있는 인기 있는 음식, 서비스 또는 상품 을 강조표시할 수 있습니다.
- "캐주얼한 공간에서 푸짐한 전통 이탈리아 요리를 제공하는 Forum Shops 식당입니다."
- "커트와 염색, 드라이를 제공하는 세련된 미용실입니다."
- "다양한 빈티지 장식, 가구, 의류를 제공하는 여러 판매업체가 있는 대형 매장입니다."
장소 요약은 장소 세부정보 (신규), 텍스트 검색 (신규), 및 주변 검색 (신규)에서 지원됩니다. 장소 요약은 지원되는 유형에 표시되는 장소 유형에 문화, 엔터테인먼트 및 레크리에이션, 음식 및 음료, 쇼핑, 서비스,스포츠 카테고리에 사용할 수 있습니다.
장소 요약은 다음 언어 및 지역의 관심 지점에서 지원됩니다.
| 언어 | 지역 |
|---|---|
| 영어 |
인도 미국 |
생성형 장소 요약 요청
응답에 장소 요약을 반환하려면 요청의 필드 마스크에 다음 필드를 포함합니다.
- 장소 세부정보 (신규):
generativeSummary - 텍스트 검색 (신규) 및 주변 검색 (신규):
places.generativeSummary
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" } } }, /.../ ] }
주변 검색 (신규) 요청
다음 주변 검색 (신규) 요청은 오리건주 포틀랜드에 있는 식당 및 카페의 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 정책을 참고하세요.