Places API를 위한 Gemini 모델 기능 (신규)은 LLM에 대한 지원을 Places API에 제공하므로 LLM에서 제공하는 데이터와 함께 장소와 관련된 데이터(영업시간, 리뷰, 사진)를 반환할 수 있습니다. 이 생성 데이터에는 LLM에서 집계 및 요약된 데이터가 포함되어 이미 장소와 연결된 데이터를 개선합니다.
예를 들어 'EV 충전소'에 대한 표준 텍스트 검색 (신규)은 전기자동차 충전을 제공하는 장소의 목록을 반환합니다. 가장 가까운 EV 충전기 또는 차량과 호환되는 가장 가까운 충전기를 검색하는 경우에는 이 유형의 응답이 적합합니다.
그러나 특히 차량을 충전하는 동안 한 시간 이상 머무르는 경우 충전소 주변 지역을 더 잘 파악하는 것이 좋습니다. 동일한 검색에 Gemini 모델 기능을 사용하면 충전소 주변 구역에 관한 정보를 포함하여 대답의 각 장소에 대한 동적 생성적 설명이 응답에 포함될 수 있습니다.
도보 2~4분 이내에 셰프 주스, 젠 한국식 BBQ 하우스, 앰버 인디아, 퍼시픽 캐치, 월마트, 홀 푸드 마켓, 트레이더 조스 등 여러 식료품점 등 다양한 식당과 쇼핑 옵션이 있습니다."
"도보로 1~5분 이내에 카오 캉 타이키친, 로저스 델리 앤 도넛, 라 코스스테냐 등 다양한 식당과 쇼핑 공간이 있습니다. 초밥으로는 Joy Sushi가 제격입니다. 식료품의 경우 Dollar Tree는 다양한 제품을 할인된 가격에 제공합니다."
LLM의 생성형 콘텐츠는 응답을 개선하고 사용자가 정보에 입각한 결정을 내리는 데 도움이 되는 추가 정보를 제공합니다.
Places API에 추가된 새로운 AI 기반 기능 (신규)
이러한 기능은 Places API (신규) 응답에 다음 데이터를 추가합니다.
특정 장소와 관련된 생성형 장소 요약. 장소 요약은 장소 세부정보 (신규), 텍스트 검색 (신규), 주변 검색 (신규)에서 지원됩니다.
생성형 영역 요약: 장소 주변의 특정 영역과 관련이 있습니다. 지역 요약은 장소 세부정보 (신규), 텍스트 검색 (신규), 주변 검색 (신규)에서 지원됩니다.
문맥 검색 결과는 텍스트 검색 (신규)에서 지원되며 장소와 직접 연결된 데이터 대신 요청에 전달된 검색 문자열을 기반으로 한 데이터를 포함합니다. 이 데이터는 텍스트 검색 (신규)이 응답을 결정하는 방식을 이해하는 데 도움이 됩니다.
생성형 장소 요약
생성형 장소 요약은 장소 ID에 따라 다릅니다. 장소 요약은 여러 유형의 데이터를 장소에 대한 단일 요약으로 집계합니다.
Places API (신규)는 두 가지 유형의 생성형 장소 요약을 제공합니다.
개요 요약: 장소에 관한 간략한 개요(평균 100자(영문 기준))로, 사용자가 장소를 한눈에 파악하는 데 도움이 될 수 있습니다.
설명 요약: 장소에 관한 긴 요약(평균 약 400자)으로 장소의 주요 측면을 다루는 자세한 개요를 제공합니다.
장소 요약은 현재 문화, 엔터테인먼트 및 레크리에이션, 식음료, 쇼핑, 스포츠 카테고리에 대해 지원되는 유형으로 표시된 장소 유형에 사용할 수 있습니다.
생성형 영역 요약
생성형 영역 요약은 LLM이 장소 주변의 주변 지역에 관해 만듭니다. 장소의 영역 요약에는 사용자가 지역 세부정보를 드릴다운하기 위해 추가로 요청할 필요 없이 결정을 내리는 데 필요한 모든 정보가 포함될 수 있습니다.
응답에는 지역 설명과 함께 설명에 참조된 장소의 장소 ID 목록과 다양한 콘텐츠 유형별로 정렬된 장소 목록도 포함됩니다. 예를 들어 한 콘텐츠 유형에는 해당 지역의 활동과 관련된 장소 목록이 포함되고 다른 콘텐츠 유형에는 해당 지역의 식당 목록이 포함됩니다.
지역 요약은 현재 숙박시설 카테고리의 지원 유형에 표시된 장소 유형 및 특정 장소 유형 electric_vehicle_charging_station, geocode, premise에서 사용할 수 있습니다.
장소 및 지역 요약 생성
생성형 장소 요약과 생성 영역 요약은 모두 Google에서 오프라인으로 자주 생성합니다. 이러한 요약을 오프라인으로 생성하면 Gemini에서 제공하는 콘텐츠를 활용하면서 Places API (신규)에서 이미 기대하는 것과 동일한 성능을 계속 확인할 수 있습니다.
Google은 사용 가능한 최신 정보를 기반으로 최신 상태인지 확인하기 위해 이러한 요약을 자주 다시 생성합니다. 즉, API를 호출할 때 서비스의 최신 데이터가 표시됩니다.
문맥 검색 결과
텍스트 검색(신규)은 문자열(예: '뉴욕의 피자' 또는 '오타와 근처의 신발 가게')을 기반으로 일련의 장소에 대한 정보를 반환합니다. 텍스트 검색(신규) 응답에는 요청에 설정된 텍스트 문자열 및 위치 상세 검색과 일치하는 장소의 목록이 포함됩니다.
응답에 문맥 검색 결과를 추가하면 이제 사용자가 질문에 답하는 데 도움이 되는 리뷰, 사진, 근거가 응답에 포함됩니다.
- 검색결과에 이 장소가 표시되는 이유는 무엇인가요?
- 이 장소를 선택해야 하는 이유
예를 들어 응답에 특정 장소가 포함된 오늘 장소 세부정보 (신규), 텍스트 검색 (신규) 또는 주변 검색 (신규)에 요청을 전송합니다. 반환된 데이터가 해당 장소와 연결되어 있으므로 장소에 대한 응답 데이터는 세 요청 모두에서 동일합니다.
그러나 새로운 기능을 사용하는 텍스트 검색 (신규)의 경우 응답에는 입력 쿼리 문자열 자체에서 파생된 데이터가 포함될 수 있습니다. 즉, 문맥 검색 결과는 쿼리 문자열마다 고유합니다. 예를 들어 다음 쿼리 문자열을 사용하여 텍스트 검색 (신규) 요청을 만듭니다.
'캘리포니아주 마운틴뷰의 매콤한 채식 레스토랑'
그런 다음 모든 입력 매개변수를 그대로 두고 쿼리 문자열을 다음으로만 변경합니다.
'캘리포니아주 마운틴뷰의 매콤한 채식 레스토랑'
두 응답에 모두 표시되는 식당의 경우 장소에 대한 응답 데이터는 장소 자체와 관련되어 있으므로 동일합니다. 하지만 문맥 검색 결과는 쿼리 문자열에서 파생되므로 쿼리마다 고유합니다. 그런 다음 문맥 검색결과의 리뷰, 사진, 근거를 사용자에게 표시하여 사용자가 검색 요청에 가장 적합한 응답 장소를 결정하는 데 도움을 줄 수 있습니다.
Places API에 Gemini 모델 기능 사용 설정 (신규)
Places API (신규)에서 Gemini 모델 기능을 사용하려면 Places API (신규)를 사용 설정해야 합니다. 자세한 내용은 Google Cloud 프로젝트 설정을 참조하세요.
실험용 버전 제한사항
이 버전에서는 미국 내 장소의 장소 및 지역 요약이 영어로만 지원됩니다.
Gemini란 무엇인가요?
Gemini 모델에 대해 자세히 알아보려면 Gemini FAQ를 참고하세요.
생성형 장소 요약 요청
장소 요약은 특정 장소에 대해 LLM이 생성하는 생성형 요약입니다. Places API (신규)는 응답에 두 가지 유형의 요약을 추가합니다.
개요: 장소와 연결된 정적 편집 요약과 유사한 생성 요약입니다. 평균적으로 약 100자(영문 기준)의 생성형 짧은 요약은 여러 가지 이점이 있습니다
많은 장소에 편집자 요약이 없으므로 장소에 대한 정보가 부족한 부분을 채웁니다.
LLM에서 생성되므로 장소 소유자가 이를 유지관리할 필요가 없습니다.
설명 생성형 요약은 Google 지도의 리뷰를 비롯한 여러 소스에서 파생됩니다. 설명(평균 약 400자)에는 긴 설명을 생성하는 데 사용되는 리뷰 목록이 포함됩니다.
직접 설명 요약을 생성하려면 여러 위치에서 데이터를 집계한 다음 콘텐츠를 수작업으로 제작하고 유지해야 합니다. Places API (신규)의 Gemini 모델 기능은 LLM에서 이러한 요약을 빌드하여 생성된 콘텐츠의 범위와 최신 상태를 유지합니다.
장소 요약은 장소 세부정보 (신규), 텍스트 검색 (신규), 주변 검색 (신규)에서 지원됩니다. 응답에 장소 요약을 포함하려면 요청의 필드 마스크에 다음 필드를 포함합니다.
장소 세부정보:
generativeSummary텍스트 검색 및 주변 검색:
places.generativeSummary
generativeSummary 필드에는 다음 필드가 포함됩니다.
generativeSummary.overview: 생성형 개요 요약입니다.generativeSummary.description: 생성형 설명 요약입니다.generativeSummary.references: 설명 요약의 콘텐츠를 제공하는 데 사용되는 최대 다섯 개의 리뷰 배열. 설명 요약이 없으면 이 배열은 비어 있습니다.
개요 요약 요청 예시
다음 텍스트 검색 예에서는 캘리포니아주 마운틴뷰의 매운 채식 레스토랑에 대한 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.overview" \
https://places.googleapis.com/v1/places:searchText
응답에는 overview.text 및 overview.languageCode가 포함된 generativeSummary.overview 필드가 포함됩니다.
{
"places": [
{
"id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
"displayName": {
"text": "Zareen's",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
"languageCode": "en-US"
}
}
},
{
"id": "ChIJETHw0F-7j4AR85V_I6OobCI",
"displayName": {
"text": "Hyderabad Dum Biryani",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
"languageCode": "en-US"
}
}
},
. . .
}
개요 및 설명 요약 요청의 예
이 예시에서는 이전 예시와 동일한 쿼리를 수행하지만 places.generativeSummary 필드 마스크를 사용하여 generativeSummary.overview, generativeSummary.description, generativeSummary.references 필드를 포함한 전체 generativeSummary 객체를 반환합니다.
{
"places": [
{
"id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
"displayName": {
"text": "Zareen's",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
"languageCode": "en-US"
},
"description": {
"text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
"languageCode": "en-US"
},
"references": {
"reviews": [
{
"name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
"relativePublishTimeDescription": "12 months ago",
"rating": 5,
"text": {
"text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
"languageCode": "en"
},
"originalText": {
"text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Anam Qureshi",
"uri": "https://www.google.com/maps/contrib/116859422317024657778/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1dl9FTSmec0x00000000-cc-rp-mo"
},
"publishTime": "2023-05-09T07:24:36Z"
},
. . .
]
}
}
},
{
"id": "ChIJETHw0F-7j4AR85V_I6OobCI",
"displayName": {
"text": "Hyderabad Dum Biryani",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
"languageCode": "en-US"
},
. . .
}
생성 영역 요약 요청
지역 요약은 장소의 주변 지역에 관해 LLM에서 생성하는 생성형 요약입니다. 지역 요약은 사용자가 장소를 결정하는 데 중요할 수 있습니다.
예를 들어 새로운 도시의 호텔을 예약하려고 할 때 요구사항에 맞는 호텔을 찾을 수 있지만 호텔 주변 지역에 대해 자세히 알아보고 싶을 수 있습니다. 주변 지역의 지도를 본 다음 지도상의 각 장소를 조사해야 하는 대신 호텔의 영역 요약을 생성할 수 있습니다.
지역 요약은 장소 세부정보 (신규), 텍스트 검색 (신규), 주변 검색 (신규)에서 지원됩니다.
응답에 영역 요약을 포함하려면 요청의 필드 마스크에 포함합니다.
areaSummary(장소 세부정보)places.areaSummary(텍스트 검색 및 주변 검색)
응답에 있는 장소의 areaSummary 필드에는 최대 4개의 contentBlocks 배열이 포함됩니다.
각 블록의 주제는 장소의 유형을 기반으로 합니다.
electric_vehicle_charging_station유형의 장소로 정의된 전기자동차 충전소의 경우 주제 블록에는"overview","coffee","restaurant","store"가 포함됩니다.유형이 숙박 시설 카테고리로 정의된 장소와 특정 장소 유형
geocode및premise인 경우 주제 블록에는"overview","activity","restaurant","store"가 포함됩니다.
전기자동차 충전소의 지역 요약 요청 예
이 장소 세부정보 요청 예에서는 장소 ID ChIJC5b6QKiwj4ARgn2EwlnJnWU로 식별되는 마운틴뷰에 있는 특정 전기자동차 충전소의 지역 요약을 반환합니다.
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,areaSummary" \ https://places.googleapis.com/v1/places/ChIJC5b6QKiwj4ARgn2EwlnJnWU
응답에는 contentBlocks 배열을 비롯한 areaSummary 필드가 포함됩니다.
topic필드는 콘텐츠 블록 유형을 지정합니다. 이 예에서는 전기자동차 충전소이므로 콘텐츠 블록 4개는"overview","coffee","restaurant","store"입니다.content필드에는 언어 코드를 비롯한 해당 주제의 요약이 포함됩니다.references배열은 콘텐츠 블록의 콘텐츠를 제공하는 데 사용되는 장소 리소스 이름을places/PLACE_ID형식으로 지정합니다.
{
"id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
"displayName": {
"text": "EVgo Charging Station",
"languageCode": "en"
},
"areaSummary": {
"contentBlocks": [
{
"topic": "overview",
"content": {
"text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
"places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
]
}
},
{
"topic": "coffee",
"content": {
"text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
]
}
},
{
"topic": "restaurant",
"content": {
"text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
"places/ChIJETHw0F-7j4AR85V_I6OobCI",
"places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
"places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
]
}
},
{
"topic": "store",
"content": {
"text": "Safeway provides a range of groceries, along with a deli and a bakery.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
]
}
}
]
}
}
호텔의 영역 요약 요청 예
다음 텍스트 검색 요청 예는 캘리포니아주 마운틴뷰에 있는 호텔을 요청합니다.
curl -X POST -d '{
"textQuery": "Hotels",
"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.areaSummary" \
https://places.googleapis.com/v1/places:searchText
응답에는 contentBlocks 배열을 비롯한 areaSummary 필드가 포함됩니다. 호텔 유형의 장소에 대한 응답에는 "overview", "activity", "restaurant", "store" 주제에 관한 콘텐츠 블록이 포함됩니다.
{
"places": [
{
"id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
"displayName": {
"text": "Shashi Hotel Mountain View, an Urban Resort",
"languageCode": "en"
},
"areaSummary": {
"contentBlocks": [
{
"topic": "overview",
"content": {
"text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJOYvCo1W3j4AR1LAifgk13rs",
"places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
"places/ChIJo4za6vi5j4ARMua093RgGGA",
"places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
]
}
},
{
"topic": "activity",
"content": {
"text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJOYvCo1W3j4AR1LAifgk13rs",
"places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
"places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
]
}
},
{
"topic": "restaurant",
"content": {
"text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
"places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
"places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
]
}
},
{
"topic": "store",
"content": {
"text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJh64-r0O3j4ARy1P41IH2j3k",
"places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
]
}
}
]
}
},
...
]
}
문맥 검색 결과 요청
텍스트 검색 (신규) 요청에 대한 응답에는 입력 검색 문자열의 기준과 일치하는 장소의 배열이 포함됩니다. 이제 API에 대한 입력 쿼리에 따라 응답에서 문맥 검색 데이터를 요청할 수 있습니다.
문맥 요약을 지원하기 위해 텍스트 검색 (신규)의 응답에는 응답의 places 배열과 동일한 수준의 contextualContents라는 새 배열이 포함됩니다.
{
"places": [],
"contextualContents":[]
}
contextualContents 배열의 각 요소(ContextualContent 유형)는 places 배열의 위치와 마찬가지로 상응하는 배열 위치에 있습니다. 즉, contextualContents[0]의 요소는 places[0]의 장소에 해당합니다.
각 배열 요소에는 다음과 같은 배열 필드가 포함됩니다.
contextualContents.reviews: 최대 3개의 리뷰 배열입니다.contextualContents.photos: 최대 5개의 사진 배열입니다.contextualContents.justifications: 다음을 포함한 장소의 근거 배열reviewJustification: 사용자 리뷰에서 최종 사용자가 관심을 가질 만한 섹션을 강조 표시합니다.businessAvailabilityAttributesJustification: 최종 사용자가 관심을 가질 만한 비즈니스 속성을 포함합니다.
응답에 문맥 검색 결과를 포함하려면 Text Search (New) 요청의 필드 마스크에 contextualContents를 포함합니다.
curl -X POST -d '{
"textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
"openNow": true,
"maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText
응답에는 응답의 각 장소에 대한 contextualContents 배열이 포함됩니다.
{
"places": [
{
"id": "ChIJETHw0F-7j4AR85V_I6OobCI",
"displayName": {
"text": "Hyderabad Dum Biryani",
"languageCode": "en"
}
},
. . .
],
"contextualContents": [
{
"reviews": [
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
"relativePublishTimeDescription": "a year ago",
"rating": 5,
"text": {
"text": "Very tasty! Rich spices and textures. We really appreciated
all of the vegan options. We shared samosas (great sauce!) , tofu 65
(spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
enjoyed all of it, with the pakoras being the table's favorite.",
"languageCode": "en"
},
"originalText": {
"text": "Very tasty! Rich spices and textures. We really appreciated
all of the vegan options. We shared samosas (great sauce!) , tofu 65
(spicy!!), gobi manchurian (less flavorful but a nice sweet offset
to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
We enjoyed all of it, with the pakoras being the table's favorite.",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Guillaume Riesen",
"uri": "https://www.google.com/maps/contrib/1131462893/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwG_WXt1SjB1rJg=s128-c-c0x00000000-cc-rp-mo-br100"
},
"publishTime": "2023-04-18T02:48:02Z"
},
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSUNKZzlhTG53RRAB",
"relativePublishTimeDescription": "10 months ago",
"rating": 5,
"text": {
"text": "This is a nice little spot to eat at. I'm a big fan of
curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
"languageCode": "en"
},
"originalText": {
"text": "This is a nice little spot to eat at. I'm a big fan of curries,
and they are spot on when it comes to flavor and spice. I highly recommend this place.",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Paul Sacks",
"uri": "https://www.google.com/maps/contrib/1106671734435/reviews",
"photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9sVQ=s128-c-c0x00000000-cc-rp-mo-ba4-br100"
},
"publishTime": "2023-07-03T16:51:49Z"
},
. . .
],
"photos": [
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
"widthPx": 1920,
"heightPx": 1080,
"authorAttributions": [
{
"displayName": "A Google User",
"uri": "//maps.google.com/maps/contrib/113209927655010465422",
"photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgycOLDgOqPRYhzJ0EJlBFyKo9OrmacOo3C5YvrtR4Q=s100-p-k-no-mo"
}
]
},
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9YNzyjkjDMD15gyobIQtIYg1GFPy3BdQHAaA3iNwhk24vK212hZo",
"widthPx": 960,
"heightPx": 720,
"authorAttributions": [
{
"displayName": "Toast"
}
]
},
. . .
],
"justifications": [
{
"reviewJustification": {
"highlightedText": {
"text": "\"Not too spicy or oily.\"",
"highlightedTextRanges": [
{
"startIndex": 9,
"endIndex": 14
}
]
},
"review": {
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
"relativePublishTimeDescription": "10 months ago",
"rating": 5,
"text": {
"text": "Not too spicy or oily. We have the mutton dum biryanis
and tandoori fish. Very flavorful. The food was served promptly.
Clean environment. A little small more like a hole in the wall.
We'd come back for sure.",
"languageCode": "en"
},
"originalText": {
"text": "Not too spicy or oily. We have the mutton dum biryanis
and tandoori fish. Very flavorful. The food was served promptly.
Clean environment. A little small more like a hole in the wall.
We'd come back for sure.",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Harpal Kochar",
"uri": "https://www.google.com/maps/contrib/1166232959/reviews",
"photoUri": "https://lh3.googleusercoEnzB1zdrNbR00000-cc-rp-mo"
},
"publishTime": "2023-06-18T06:12:41Z"
}
}
},
{
"businessAvailabilityAttributesJustification": {
"dineIn": true
}
}
]
},
. . .
]
}
자동차 사용 사례를 위한 구현 안내
운전자의 안전을 위해 자동차 환경의 주차 모드에서 생성형 AI 요약을 렌더링하는 것이 좋습니다. 운전 모드에서 요약을 렌더링하는 경우 운전자의 주의가 빠르게 도로로 돌아갈 수 있도록 화면 정보는 간단하고 명확하며 간결해야 합니다.
- 3줄 이하여야 합니다.
- 120자(영문 기준) 또는 24단어 이하
- 최소 전면 크기 24dp
특히 자동차 환경에서 모든 현지 법률 및 규정을 준수하는 안전한 방식으로 생성형 AI 요약을 렌더링하는 것은 개발자의 책임입니다.
기여 분석
장소 및 지역 요약을 포함하여 앱에 리뷰, 사진, 생성형 AI 요약을 표시할 때는 필수 저작자 표시도 표시해야 합니다.
생성형 요약의 기여 분석 표시
장소 및 영역 요약을 포함하여 앱에 생성형 AI 요약을 표시할 때는 필요한 속성도 표시해야 합니다. 이 섹션에서는 앱에 생성형 AI 요약을 표시하는 방법에 따라 기여 분석을 표시하는 방법을 설명합니다.
모든 경우에 저작자 표시는 문장 첫 글자 대문자를 사용해야 합니다. 저작자 표시 및 Google 로고는 모든 색상, 스타일, 서체 표준을 준수해야 합니다. 이러한 표준에 관한 자세한 내용은 Places API 정책 (신규)을 참고하세요.
다른 Google 데이터의 컨텍스트에 표시되는 생성형 AI 요약
이 경우 생성형 AI 저작자 표시는 Google의 저작자 표시에 따라 요약 위 또는 아래에 단독으로 표시될 수 있습니다.
기여 분석에는 다음 이미지와 같이 'AI로 요약됨' 텍스트를 사용하세요.
별도로 표시되는 생성형 AI 요약
생성형 AI 요약이 Google 지도의 다른 콘텐츠와 분리되어 표시되는 경우 생성형 AI 기여 분석과 Google에 대한 저작자 표시가 둘로 나뉘어 있어야 합니다. 기여 분석에는 다음 이미지와 같이 'AI로 요약' 텍스트와 Google 로고를 사용하세요.
목록에서 반복되는 생성형 AI 요약
장소 목록에서 생성형 AI 장소 요약 개요를 반복할 때 각 항목의 의미는 다음과 같습니다.
- 목록 콘텐츠의 출처는 Google입니다.
- 표시된 요약은 AI로 생성되었습니다.
- Google에서 제공하는 콘텐츠
저작자 표시는 목록 위 또는 아래에 한 줄로 표시해야 합니다. AI 기여 분석은 왼쪽 정렬되고 Google 기여 분석은 오른쪽 정렬됩니다.
긴 형식의 생성형 AI 설명 요약이 목록에 사용되는 경우 각 요약에 AI 기여 분석('AI로 요약')이 있어야 합니다(정보 아이콘/버튼 사용 시).
대화상자에 생성형 AI 요약에 관한 정보 표시
생성형 AI 요약과 함께 요약에 대한 정보와 문제를 신고할 수 있는 링크를 표시하는 대화상자를 최종 사용자에게 제공해야 합니다. 생성형 AI 설명 요약을 사용할 때는 references라고 하는 요약의 출처에 관한 정보를 포함해야 합니다.
위 예시에 설명된 대로 AI 저작자 표시와 함께 정보 아이콘을 상호작용 어포던스로 포함하고 AI 저작자 표시 영역 및 아이콘이 누르기/클릭에 응답하도록 하여 이 대화상자에 대한 액세스를 사용 설정합니다.
생성형 장소 요약의 경우 다음을 표시합니다.
| 정보 | AI 장소 요약은 Google 리뷰 및 기타 데이터를 기반으로 생성됩니다. |
| 문제 신고 | 요약 내용에 관한 문제를 Google에 신고하려면 이 링크를 클릭하세요. |
| 참조 | 소스 리뷰 |
예를 들면 다음과 같습니다.
생성 영역 요약의 경우 다음을 표시합니다.
| 정보 | AI 영역 요약은 Google 리뷰 및 지역 데이터를 기반으로 생성됩니다. |
| 문제 신고 | 요약 내용에 관한 문제를 Google에 신고하려면 이 링크를 클릭하세요. |
