Możliwości modelu Gemini w interfejsie Places API (nowy) zapewniają obsługę LLM w interfejsie Places API, dzięki czemu możesz zwracać dane powiązane z miejscem (godziny otwarcia, opinie, zdjęcia) wraz z danymi udostępnianymi przez LLM. Te dane generatywne zawierają zagregowane i podsumowane dane z LLM, które służą do wzbogacania danych już powiązanych z danym miejscem.
Na przykład standardowe wyszukiwanie tekstowe (nowe) z frazą „stacje ładowania EV” zwraca listę miejsc, które oferują ładowanie EV. Ten typ odpowiedzi jest odpowiedni, jeśli szukasz najbliższej ładowarki EV lub najbliższej ładowarki zgodnej z Twoim pojazdem.
Warto też lepiej poznać okolicę stacji ładowania, zwłaszcza jeśli zamierzasz tam spędzić godzinę lub dłużej, podczas gdy pojazd będzie się ładować. Gdy w ramach tego samego wyszukiwania korzystasz z możliwości modelu Gemini, odpowiedź może zawierać dynamiczne, generatywne opisy każdego miejsca, w tym informacje o obszarze wokół stacji ładowania:
„W odległości 2–4 minut spacerem znajduje się kilka restauracji i sklepów, takich jak Chef Chu's, Gen Korean BBQ House, Amber India, Pacific Catch oraz kilka sklepów spożywczych, takich jak Walmart, Whole Foods Market i Trader Joe's”.
„W odległości 1–5 minut spacerem znajduje się kilka restauracji i sklepów, w tym Khao Kang Thai Kitchen, Roger's Deli & Donuts i La Costeña. Jeśli chodzi o sushi, dobrym wyborem jest Joy Sushi. W Dollar Tree znajdziesz różne produkty w niskich cenach.
Treści generowane przez LLM-y wzbogacają odpowiedź i zawierają dodatkowe informacje, które pomagają użytkownikom podejmować świadome decyzje.
Dodanie nowych funkcji opartych na AI do interfejsu Places API (nowość)
Te funkcje dodają do odpowiedzi interfejsu Places API (New) te dane:
generowane automatycznie podsumowania dotyczące miejsc powiązane z konkretnym miejscem. Podsumowania miejsc są obsługiwane przez szczegóły miejsc (nowa funkcja), wyszukiwanie tekstowe (nowa funkcja) i wyszukiwanie w okolicy (nowa funkcja).
generowane podsumowania obszarów, które są powiązane z konkretnym obszarem wokół miejsca. Podsumowania obszarów są obsługiwane przez szczegóły miejsca (nowa wersja), wyszukiwanie tekstowe (nowa wersja) i wyszukiwanie w okolicy (nowa wersja).
Wyniki wyszukiwania kontekstowego są obsługiwane przez wyszukiwanie tekstowe (nowe) i zawierają dane oparte na ciągu wyszukiwania przekazanym w żądaniu, a nie na danych bezpośrednio powiązanych z miejscem. Te dane pomagają zrozumieć, jak wyszukiwanie tekstowe (nowa wersja) określa odpowiedź.
Generatywne podsumowania miejsc
Generatywne podsumowania miejsc są powiązane z identyfikatorem miejsca. Podsumowania miejsc zbierają wiele różnych typów danych w jednym podsumowaniu.
Places API (nowość) udostępnia 2 typy generowanych podsumowań miejsc:
Podsumowania: krótkie podsumowanie informacji o miejscu (średnio około 100 znaków), które pomaga użytkownikom uzyskać ogólny obraz danego miejsca.
Podsumowania opisu: dłuższe podsumowania informacji o miejscu (średnio około 400 znaków), które zawierają szczegółowy przegląd najważniejszych aspektów danego miejsca.
Podsumowania miejsc są obecnie dostępne w przypadku typów miejsc podanych w sekcji Obsługiwane typy w kategoriach Kultura, Rozrywka i rekreacja, Jedzenie i picie, Zakupy oraz Sport.
Generatywne podsumowania obszarów
Generatywna AI tworzy podsumowania obszarów dla pobliskiej okolicy miejsca. Podsumowanie obszaru może zawierać wszystkie informacje potrzebne użytkownikowi do podjęcia decyzji, bez konieczności wysyłania kolejnych żądań w celu uzyskania szczegółowych informacji o danym obszarze.
Oprócz opisu obszaru odpowiedź zawiera też listę identyfikatorów miejsc, do których odwołuje się opis, oraz listę miejsc posortowanych według różnych typów treści. Na przykład jeden typ treści zawiera listę miejsc związanych z działaniami w danym regionie, a inny – listę restauracji w tym regionie.
Podsumowania obszarów są obecnie dostępne w przypadku typów miejsc wyświetlanych w obsługiwanych typach w kategorii Noclegi, a także w przypadku typów miejsc electric_vehicle_charging_station, geocode i premise.
Generowanie podsumowań miejsc i obszarów
Zarówno podsumowania generowane przez generatywną usługę miejsc, jak i podsumowania generowane przez generatywną usługę obszaru są często generowane przez Google w trybie offline. Generując te podsumowania w trybie offline, możesz korzystać z treści generowanych przez Gemini, jednocześnie uzyskując oczekiwaną wydajność interfejsu Places API (New).
Google często odtwarza te podsumowania, aby były aktualne i oparte na najnowszych dostępnych informacjach. Oznacza to, że po wywołaniu interfejsu API wyświetlisz w swojej usłudze najnowsze dane.
Wyniki wyszukiwania kontekstowego
Wyszukiwanie tekstowe (nowa funkcja) zwraca informacje o zbiorze miejsc na podstawie ciągu znaków, np. „pizza w Nowym Jorku” lub „sklepy obuwnicze w pobliżu Ottawy”. Odpowiedź na zapytanie tekstowe (nowa) zawiera listę miejsc pasujących do ciągu tekstowego oraz wszelkie ustawienia preferencji lokalizacji podane w żądaniu.
Gdy dodasz do odpowiedzi wyniki wyszukiwania kontekstowego, odpowiedź będzie zawierać opinie, zdjęcia i uzasadnienia, które pomogą użytkownikom odpowiedzieć na te pytania:
- Dlaczego to miejsce pojawia się w wynikach?
- Dlaczego warto wybrać to miejsce?
Na przykład wysyłasz żądanie do usługi Szczegóły miejsca (Nowa), wyszukiwania tekstowego (Nowa) lub wyszukiwania w pobliżu (Nowa), które zawiera w odpowiedzi określone miejsce. Dane odpowiedzi dotyczące tego miejsca są takie same we wszystkich 3 przypadkach, ponieważ zwrócone dane są powiązane z tym miejscem.
W przypadku zapytania tekstowego (Nowy) korzystającego z nowych funkcji odpowiedź może jednak zawierać dane pochodzące z samego ciągu zapytania wejściowego. Oznacza to, że wyniki wyszukiwania kontekstowego są unikalne dla ciągu zapytania. Na przykład wysyłasz żądanie wyszukiwania tekstowego (nowej wersji) z tym ciągiem zapytania:
„Ostra wegetariańska restauracja w Mountain View w Kalifornii”
Następnie pozostawiasz wszystkie parametry wejściowe bez zmian i modyfikujesz tylko ciąg zapytania:
„Ostra wegetariańska restauracja w Mountain View w Kalifornii”
W przypadku restauracji, która pojawia się w obu odpowiedziach, dane o niej są takie same, ponieważ są powiązane z tą restauracją. Wyniki wyszukiwania kontekstowego są jednak unikalne dla zapytania, ponieważ pochodzą z łańcucha zapytania. Możesz wyświetlać użytkownikom opinie, zdjęcia i uzasadnienia z kontekstowych wyników wyszukiwania, aby pomóc im zdecydować, które miejsce w odpowiedzi najlepiej odpowiada ich zapytaniu.
Włączanie funkcji modelu Gemini w przypadku interfejsu Places API (nowość)
Aby korzystać z funkcji modelu Gemini w interfejsie Places API (New), musisz go włączyć. Więcej informacji znajdziesz w artykule Konfigurowanie projektu Google Cloud.
Ograniczenia wersji eksperymentalnej
Ta wersja obsługuje tylko podsumowania miejsc i obszarów w Stanach Zjednoczonych w języku angielskim.
Co to jest Gemini?
Więcej informacji o modelu Gemini znajdziesz w artykule Najczęstsze pytania dotyczące Gemini.
Wysyłanie prośby o generowanie podsumowania
Podsumowania miejsc to generowane podsumowania tworzone przez LLM dla konkretnego miejsca. Interfejs Places API (nowy) dodaje do odpowiedzi 2 rodzaje podsumowań:
Omówienie – generowane automatycznie podsumowania podobne do statycznych podsumowań redakcyjnych powiązanych z miejscem. Generowane krótkie podsumowania, które mają średnio około 100 znaków, mają kilka zalet:
Wiele miejsc nie ma podsumowań redakcyjnych, więc uzupełniają one lukę w dostępnych informacjach.
Są one generowane na podstawie LLM, więc właściciel miejsca nie musi ich aktualizować.
Opis generowane podsumowania pochodzą z wielu źródeł, w tym z opinii z Map Google. Opis, który ma średnio około 400 znaków, zawiera listę opinii użytych do wygenerowania długiego opisu.
Aby wygenerować podsumowania ręcznie, trzeba zebrać dane z wielu miejsc, a potem ręcznie utworzyć i utrzymywać treści. Funkcje modelu Gemini w przypadku interfejsu Places API (New) tworzą te podsumowania na podstawie modeli językowych, aby zachować zakres i świeżość generowanych treści.
Podsumowania miejsc są obsługiwane przez szczegóły miejsc (nowa funkcja), wyszukiwanie tekstowe (nowa funkcja) i wyszukiwanie w okolicy (nowa funkcja). Aby uwzględnić w odpowiedzi podsumowanie miejsca, w polu maski żądania umieść to pole:
Szczegóły miejsca:
generativeSummaryWyszukiwanie tekstowe i wyszukiwanie w pobliżu:
places.generativeSummary
Pole generativeSummary zawiera te pola:
generativeSummary.overview: podsumowanie generative overview.generativeSummary.description: wygenerowany opis podsumowania.generativeSummary.references: tablica zawierająca do 5 opinii, które służą do wyświetlania treści w podsumowaniu opisu. Jeśli nie ma podsumowania opisu, tablica jest pusta.overviewFlagContentUri: link, pod którym użytkownicy mogą zgłosić problem z podsumowaniem podsumowania.descriptionFlagContentUri: link, w którym użytkownicy mogą zgłosić problem z podsumowaniem opisu.
Przykładowa prośba o podsumowanie podglądu i opisu
W tym przykładzie maska pola places.generativeSummary zwraca cały obiekt generativeSummary, w tym pola generativeSummary.overview, generativeSummary.description i generativeSummary.references:
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
Odpowiedź ma postać:
{
"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": "John Smith",
"uri": "https://www.google.com/maps/contrib/11685942231/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo"
},
"publishTime": "2023-05-09T07:24:36Z"
"flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670"
},
. . .
]
},
"overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12",
"descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12"
}
},
{
"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"
},
. . .
}Przykładowa prośba o podsumowanie
W tym przykładzie wyszukiwanie tekstowe zwraca tylko podsumowanie overview dotyczące wegetariańskich restauracji serwujących pikantne dania w Mountain View w Kalifornii:
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
Odpowiedź zawiera pole generativeSummary.overview, które zawiera pola overview.text i overview.languageCode:
{
"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"
}
}
},
. . .
}Wysyłanie prośby o podsumowanie obszaru generatywnego
Podsumowania obszaru to generowane podsumowania tworzone przez LLM dla pobliskiej okolicy miejsca. Podsumowania dotyczące obszaru mogą być ważne dla użytkowników, którzy podejmują decyzję o wybraniu miejsca.
Chcesz np. zarezerwować pokój w hotelu w nowym mieście. Znajdujesz hotel, który spełnia Twoje wymagania, ale chcesz też dowiedzieć się więcej o okolicy. Zamiast przeglądać mapę okolicy, a potem sprawdzać poszczególne miejsca na mapie, możesz wygenerować podsumowanie obszaru dla hotelu.
Podsumowania obszarów są obsługiwane przez szczegóły miejsca (nowa wersja), wyszukiwanie tekstowe (nowa wersja) i wyszukiwanie w okolicy (nowa wersja).
Aby podsumowanie obszaru było uwzględnione w odpowiedzi, w polu maski żądania podaj:
areaSummary(szczegóły miejsca)places.areaSummary(wyszukiwanie tekstowe i wyszukiwanie w pobliżu).
Pole areaSummary w przypadku miejsca w odpowiedzi zawiera pole flagContentUri, za pomocą którego możesz zgłosić nieodpowiednie treści, aby Google mogło je usunąć. Zawiera też tablicę z maksymalnie 4 contentBlocks.
Temat każdego bloku zależy od typu miejsca:
W przypadku stacji ładowania EV zdefiniowanej jako miejsce typu
electric_vehicle_charging_stationbloki tematyczne obejmują:"overview","coffee","restaurant"i"store".W przypadku miejsca o typie zdefiniowanym przez kategorię Noclegi oraz konkretne typy miejsc
geocodeipremisebloki tematów obejmują:"overview","activity","restaurant"i"store".
Przykładowe żądanie podsumowania obszaru stacji ładowania EV
To przykładowe żądanie szczegółów miejsca zwraca podsumowanie obszaru dotyczące konkretnej stacji ładowania EV w Mountain View, zidentyfikowanej za pomocą identyfikatora miejsca:
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
Odpowiedź zawiera pole areaSummary, w tym tablicę contentBlocks:
Pole
topicokreśla typ bloku treści. Ponieważ w tym przykładzie jest to stacja ładowania EV, 4 bloki treści to"overview","coffee","restaurant"i"store".Pole
contentzawiera podsumowanie tego tematu, w tym kod języka.Tablica
referencesokreśla nazwy zasobów miejsc w formieplaces/PLACE_ID, które służą do wyświetlania treści w bloku treści.
{
"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"
]
}
}
],
"flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12"
}
}Przykładowe żądanie podsumowania obszaru dla hotelu
W tym przykładowym żądaniu wyszukiwania tekstu są uwzględnione hotele w Mountain View w Kalifornii:
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
Odpowiedź zawiera pole areaSummary, w tym tablicę contentBlocks. Odpowiedź dla miejsc typu hotel zawiera bloki treści dotyczące tych tematów: "overview", "activity", "restaurant" i "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" ] } } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12" } }, ... ] }
Prośba o wyniki wyszukiwania kontekstowego
Odpowiedź na żądanie Text Search (New) zawiera tablicę miejsc, które spełniają kryteria podanego ciągu wyszukiwania. Teraz możesz poprosić o dane wyszukiwania kontekstowego w odpowiedzi na podstawie zapytania wejściowego przesłanego do interfejsu API.
Aby obsługiwać podsumowania kontekstowe, odpowiedź z wyszukiwania tekstowego (nowej wersji) zawiera nowy tablicę o nazwie contextualContents na tym samym poziomie co tablica places w odpowiedzi:
{
"places": [],
"contextualContents":[]
}Każdy element w tablicy contextualContents typu ContextualContent znajduje się w odpowiedniej lokalizacji tablicy, tak jak miejsce w tablicy places. Oznacza to, że element contextualContents[0] odpowiada miejscu places[0].
Każdy element tablicy zawiera te pola:
contextualContents.reviews: tablica zawierająca maksymalnie 3 opinie.contextualContents.photos: tablica zawierająca do 5 zdjęć.contextualContents.justifications: tablica uzasadnień miejsca, w tym:reviewJustification: wyróżnia część opinii użytkownika, która może zainteresować użytkownika końcowego.businessAvailabilityAttributesJustification: zawiera atrybuty firmy, które mogą być interesujące dla użytkownika.
Aby uwzględnić w odpowiedzi wyniki wyszukiwania kontekstowego, dodaj contextualContents do maski pola w prośbie wyszukiwania tekstowego (nowej):
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
Odpowiedź zawiera tablicę contextualContents dla każdego miejsca w odpowiedzeniu:
{
"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": "Jane Doe",
"uri": "https://www.google.com/maps/contrib/113193/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100"
},
"publishTime": "2023-04-18T02:48:02Z",
"flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db"
},
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB",
"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": "Bob Jones",
"uri": "https://www.google.com/maps/contrib/11034435/reviews",
"photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100"
},
"publishTime": "2023-07-03T16:51:49Z",
"flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db"
},
. . .
],
"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/113010465422",
"photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo"
}
],
"flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db"
},
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo",
"widthPx": 960,
"heightPx": 720,
"authorAttributions": [
{
"displayName": "Toast"
}
],
"flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db"
},
. . .
],
"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": "Stan Davis",
"uri": "https://www.google.com/maps/contrib/112959/reviews",
"photoUri": "https://lh3.googleuser-cc-rp-mo"
},
"publishTime": "2023-06-18T06:12:41Z",
"flagContentUri": "https://www.google.com/local/review/rap/report?postt=1",
"googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db"
}
}
},
{
"businessAvailabilityAttributesJustification": {
"dineIn": true
}
}
]
},
. . .
]
}Wskazówki dotyczące implementacji w przypadku zastosowań motoryzacyjnych
Ze względu na bezpieczeństwo kierowcy Google zaleca renderowanie generatywnej AI w trybie zaparkowanym. Jeśli podsumowania są renderowane w trybie jazdy, informacje na ekranie powinny być proste, przejrzyste i zwięzłe, aby kierowca mógł szybko wrócić do obserwowania drogi.
- Nie więcej niż 3 wiersze
- 120 znaków lub 24 słowa
- Minimalny rozmiar z przodu: 24 dp
Zwłaszcza w przypadku samochodów deweloper jest odpowiedzialny za renderowanie podsumowań generatywnej AI w sposób bezpieczny i zgodny ze wszystkimi lokalnymi przepisami i regulacjami.
Atrybucje
Jeśli wyświetlasz w aplikacji opinie, zdjęcia i podsumowania generowane przez AI, w tym podsumowania dotyczące miejsc i obszarów, musisz też wyświetlać wymagane informacje o źródłach.
Wyświetlanie informacji o źródłach w przypadku podsumowań generowanych
Jeśli wyświetlasz w aplikacji podsumowania wygenerowane przez sztuczną inteligencję, w tym podsumowania miejsc i obszarów, musisz też wyświetlać niezbędne informacje o źródle. Z tej sekcji dowiesz się, jak wyświetlać informacje o autorze na podstawie sposobu wyświetlania w aplikacji podsumowań wygenerowanych przez generatywną AI.
W każdym przypadku atrybucja musi być zapisana z wielkości liter jak w zdaniu. Logo Google i informacje o atrybucji muszą być zgodne ze wszystkimi standardami dotyczącymi kolorów, stylu i króju pisma. Więcej informacji o tych standardach znajdziesz w zasadach dotyczących interfejsu Places API (nowej wersji).
Podsumowanie generatywnej AI wyświetlane w kontekście innych danych Google
W takim przypadku informacja o autorze generowanej przez AI treści może być wyświetlana samodzielnie nad lub pod podsumowaniem, a przypis do treści będzie pochodzić z Google.
W przypadku informacji o autorze użyj tekstu „Podsumowanie przez AI”, jak pokazano na tym obrazie:
Podsumowanie generatywnej AI wyświetlane osobno
Gdy podsumowanie generatywnej AI pojawia się bez innych treści z Map Google, musi zawierać zarówno informacje o generatywnej AI, jak i o Google, rozdzielone przecinkiem. W informacjach o źródle użyj tekstu „Summarized by AI” i logo Google, jak pokazano na tym obrazie:
Podsumowanie generatywnej AI powtórzone na liście
Podczas powtarzania generatywnej AI poglądu na podsumowanie miejsca na liście miejsc, w której:
- Treści na liście są przypisywane do Google
- Wyświetlane podsumowania są generowane przez AI.
- Treści są dostępne od Google
Oznaczenie powinno być wyświetlane nad lub pod listą na jednej linii. Atrybucja AI jest wyrównana do lewej, a atrybucja Google – do prawej:
Jeśli na liście są używane dłuższe podsumowania opisu wygenerowane przez generatywną AI, każde podsumowanie musi zawierać informacje o źródle (np. „Podsumowanie wygenerowane przez AI” z ikoną lub przyciskiem z informacjami).
Wyświetlanie informacji o streszczonym tekście wygenerowanym przez AI w dialogu
Oprócz podsumowania generowanego przez generatywną AI musisz udostępnić użytkownikom dialog wyświetlający informacje o podsumowaniu oraz link do zgłaszania problemów za pomocą unikalnego identyfikatora podsumowania zawartego w polu flagContentUri. Jeśli używasz generatywnej AI do podsumowania opisu, musisz podać informacje o źródłach tego podsumowania, czyli odniesieniach.
Umożliw dostęp do tego okna, dodając ikonę informacji (jako element interaktywności) w połączeniu z atrybucją AI (jak w przypadku powyższych przykładów) oraz sprawiając, że obszar atrybucji AI i ikona będą reagować na naciśnięcie lub kliknięcie.
W przypadku generowanych podsumowań miejsc wyświetlaj:
| Informacje | Streszczenia miejsc generowane przez AI są tworzone na podstawie opinii w Google i innych danych. |
| Zgłoś problem | Aby zgłosić Google problem z treścią podsumowania, użyj linku zawartego w polu flagContentUri. |
| Pliki referencyjne | Opinie źródłowe |
Na przykład:
W przypadku podsumowań generowanych obszarów wyświetlaj:
| Informacje | Podsumowania obszarów generowane przez AI są tworzone na podstawie opinii w Google i danych lokalnych. |
| Zgłoś problem | Aby zgłosić Google problem z treścią podsumowania, użyj linku zawartego w polu flagContentUri. |
