Die Gemini-Modellfunktionen für die Places API (New) unterstützen LLMs in der Places API, sodass Sie die mit einem Ort verknüpften Daten (Öffnungszeiten, Rezensionen, Fotos) zusammen mit den von LLMs bereitgestellten Daten zurückgeben können. Diese generativen Daten enthalten aggregierte und zusammengefasste Daten aus den LLMs, um die bereits mit einem Ort verknüpften Daten zu verbessern.
Eine standardmäßige Text Search (New)-Funktion für „Ladestationen für Elektrofahrzeuge“ gibt beispielsweise eine Liste von Orten zurück, an denen Ladestationen für Elektrofahrzeuge angeboten werden. Diese Art von Antwort ist in Ordnung, wenn Sie nur nach dem nächsten Ladegerät für Elektrofahrzeuge oder dem nächsten für Ihr Fahrzeug geeigneten Ladegerät suchen.
Möglicherweise möchten Sie sich aber auch einen besseren Überblick über die Umgebung um die Ladestation verschaffen, insbesondere wenn Sie eine Stunde oder länger dort sind, während Ihr Fahrzeug lädt. Wenn die Gemini-Modellfunktionen für dieselbe Suche verwendet werden, kann die Antwort dynamische, generative Beschreibungen der einzelnen Orte in der Antwort enthalten, einschließlich Informationen zur Umgebung der Ladestation:
„Im Umkreis von 2 bis 4 Gehminuten gibt es mehrere Restaurants und Einkaufsmöglichkeiten, darunter Chef Chu's, Gen Korean BBQ House, Amber India, Pacific Catch sowie mehrere Lebensmittelgeschäfte wie Walmart, Whole Foods Market und Tradeer Joe's.“
„Im Umkreis von 1–5 Gehminuten gibt es mehrere Restaurants und Einkaufsmöglichkeiten, darunter Khao Kang Thai Kitchen, Roger's Deli & Donuts und La Costeña. Sushi wird in Joy Sushi angeboten. Für Lebensmittel bietet Dollar Tree eine Vielzahl von Produkten zu ermäßigten Preisen an.“
Diese generativen Inhalte der LLMs verbessern die Reaktion und liefern zusätzliche Informationen, die Nutzern dabei helfen, eine fundierte Entscheidung zu treffen.
Neue KI-basierte Funktionen in Places API (neu)
Diese Funktionen fügen einer Places API (New)-Antwort die folgenden Daten hinzu:
Generative Ortszusammenfassungen, die sich auf einen bestimmten Ort beziehen. Ortszusammenfassungen werden von Place Details (New), Text Search (New) und Nearby Search (New) unterstützt.
Generative Gebietszusammenfassungen, die sich auf ein bestimmtes Gebiet um einen Ort herum beziehen. Zusammenfassungen von Gebieten werden von Place Details (New), Text Search (New) und Nearby Search (New) unterstützt.
Ergebnisse der kontextbasierten Suche werden von Text Search (New) unterstützt und enthalten Daten, die auf dem in der Anfrage übergebenen Suchstring basieren, nicht auf Daten, die direkt mit einem Ort verknüpft sind. Diese Daten helfen zu verstehen, wie „Text Search (New)“ die Antwort bestimmt.
KI-generierte Ortszusammenfassungen
Generative Ortszusammenfassungen sind spezifisch für eine Orts-ID. Bei einer Ortszusammenfassung werden viele verschiedene Datentypen in einer einzigen Zusammenfassung für den Ort zusammengefasst.
Die Places API (New) bietet zwei Arten von mit generativer Zusammenfassungen erstellten Orten:
Zusammenfassungen der Übersicht: Eine kurze Übersicht über einen Ort mit durchschnittlich etwa 100 Zeichen, die Nutzern helfen kann, sich einen Überblick über den Ort zu verschaffen.
Beschreibungen: Längere Zusammenfassungen eines Orts mit durchschnittlich etwa 400 Zeichen, die einen detaillierten Überblick über die wichtigsten Aspekte des Orts bieten.
Ortszusammenfassungen sind derzeit für Ortstypen verfügbar, die unter Unterstützte Typen für die Kategorien Kultur, Unterhaltung und Freizeit, Essen und Trinken, Shopping und Sport angezeigt werden.
Zusammenfassungen von KI-generierten Gebieten
Generative Gebietszusammenfassungen werden vom LLM für den nahe gelegenen Bereich um einen Ort erstellt. Die Bereichszusammenfassung für einen Ort kann alle Informationen enthalten, die der Nutzer für seine Entscheidung benötigt, ohne dass er weitere Anfragen stellen muss, um die Details des Gebiets aufzuschlüsseln.
Neben einer Beschreibung des Gebiets enthält die Antwort auch eine Liste von Orts-IDs für die Orte, auf die in der Beschreibung verwiesen wird, sowie eine Liste von Orten, sortiert nach verschiedenen Inhaltstypen. Ein Inhaltstyp enthält beispielsweise eine Liste von Orten, die mit Aktivitäten in der Gegend verknüpft sind, und ein anderer enthält eine Liste mit Restaurants in der Umgebung.
Zusammenfassungen sind derzeit für Ortstypen verfügbar, die unter Unterstützte Typen für die Kategorie Unterkünfte aufgeführt sind, sowie für die spezifischen Ortstypen electric_vehicle_charging_station, geocode und premise.
Erstellen von Orts- und Gebietszusammenfassungen
Sowohl die KI-generierten Ortszusammenfassungen als auch die KI-generierten Gebietszusammenfassungen werden häufig offline von Google generiert. Wenn du diese Zusammenfassungen offline erstellst, kannst du die von Gemini bereitgestellten Inhalte nutzen und gleichzeitig dieselbe Leistung wie mit der Places API (New) erzielen.
Google erstellt diese Zusammenfassungen regelmäßig neu, damit sie auf Grundlage der neuesten verfügbaren Informationen aktuell sind. Das bedeutet, dass die aktuellen Daten in Ihrem Dienst angezeigt werden, wenn Sie die API aufrufen.
Kontextbezogene Suchergebnisse
Bei „Text Search (New)“ werden Informationen zu verschiedenen Orten auf Grundlage eines Strings zurückgegeben, z. B. „Pizza in München“ oder „Schuhgeschäfte in der Nähe von Hamburg“. Die Antwort „Text Search (New)“ enthält eine Liste von Orten, die dem Textstring und der in der Anfrage festgelegten Standortgewichtung entsprechen.
Wenn du der Antwort kontextbezogene Suchergebnisse hinzufügst, enthält die Antwort jetzt Rezensionen, Fotos und Begründungen, die Nutzern bei der Beantwortung der Fragen helfen:
- Warum wird dieser Ort in den Ergebnissen angezeigt?
- Warum sollte ich mich für diesen Ort entscheiden?
Angenommen, Sie stellen eine Anfrage an „Place Details (New)“, „Text Search (New)“ oder „Nearby Search (New)“, die einen bestimmten Ort in der Antwort enthält. Die Antwortdaten für den Ort sind für alle drei Anfragen gleich, da die zurückgegebenen Daten diesem Ort zugeordnet sind.
Bei einer „Text Search (New)“, die die neuen Funktionen verwendet, kann die Antwort jedoch Daten enthalten, die aus dem Eingabeabfragestring selbst abgeleitet sind. Das bedeutet, dass die kontextbezogenen Suchergebnisse für den Abfragestring eindeutig sind. Sie stellen beispielsweise eine „Text Search (New)“-Anfrage mit dem folgenden Abfragestring:
„Scharfes vegetarisches Restaurant in Mountain View, Kalifornien“
Dann lassen Sie alle Eingabeparameter unverändert und ändern nur den Abfragestring so:
„Spicy vegan Restaurant in Mountain View, CA, USA“
Bei einem Restaurant, das in beiden Antworten enthalten ist, sind die Antwortdaten zum Ort identisch, da diese Daten dem Ort selbst zugeordnet sind. Die kontextbezogenen Suchergebnisse sind jedoch einzigartig für die Abfrage, da sie aus dem Abfragestring abgeleitet werden. Sie können Ihren Nutzern dann die Rezensionen, Fotos und Begründungen aus den kontextbezogenen Suchergebnissen anzeigen lassen, um ihnen bei der Entscheidung zu helfen, welcher Ort in der Antwort am ehesten auf ihre Suchanfrage zutrifft.
Gemini-Modellfunktionen für Places API aktivieren (Neu)
Sie müssen die Places API (New) aktivieren, um die Gemini-Modellfunktionen für die Places API (New) verwenden zu können. Weitere Informationen finden Sie unter Google Cloud-Projekt einrichten.
Einschränkungen für den experimentellen Release
In dieser Version werden Zusammenfassungen von Orten in den USA nur auf Englisch unterstützt.
Was ist Gemini?
Weitere Informationen zum Gemini-Modell findest du in den FAQs zu Gemini.
KI-generierte Ortszusammenfassung anfordern
Ortszusammenfassungen sind generative Zusammenfassungen, die vom LLM für einen bestimmten Ort erstellt werden. Places API (New) fügt zwei Arten von Zusammenfassungen zu Antworten hinzu:
Übersicht: Generative Zusammenfassungen, die der statischen redaktionellen Zusammenfassung für einen Ort ähneln. Generative Kurzzusammenfassungen mit durchschnittlich etwa 100 Zeichen bieten mehrere Vorteile:
Viele Unternehmen haben keine redaktionellen Zusammenfassungen und füllen daher die Lücke in den verfügbaren Informationen zu einem Ort.
Sie werden vom LLM generiert und müssen nicht vom Inhaber des Orts verwaltet werden.
Die generativen Zusammenfassungen für Beschreibungen stammen aus vielen Quellen, einschließlich Rezensionen aus Google Maps. Die Beschreibung, die durchschnittlich etwa 400 Zeichen lang ist, enthält eine Liste von Rezensionen, aus denen die lange Beschreibung generiert wird.
Um Zusammenfassungen von Beschreibungen manuell zu erstellen, muss eine Person Daten von vielen Standorten aggregieren und die Inhalte dann handwerklich erstellen und pflegen. Die Gemini-Modellfunktionen für die Places API (New) erstellen diese Zusammenfassungen aus den LLMs, um den Umfang und die Aktualität der generierten Inhalte zu gewährleisten.
Ortszusammenfassungen werden von Place Details (New), Text Search (New) und Nearby Search (New) unterstützt. Um die Ortszusammenfassung in die Antwort aufzunehmen, fügen Sie das folgende Feld in die Feldmaske der Anfrage ein:
Place Details (Ortsdetails):
generativeSummaryText Search und Nearby Search:
places.generativeSummary
Das Feld generativeSummary enthält die folgenden Felder:
generativeSummary.overview: Die Zusammenfassung der generativen Übersicht.generativeSummary.description: Die Zusammenfassung der generativen Beschreibung.generativeSummary.references: Ein Array mit bis zu fünf Rezensionen, in denen Inhalte für die Zusammenfassung bereitgestellt werden. Wenn keine Beschreibungszusammenfassung vorhanden ist, ist dieses Array leer.
Beispiel für eine Anfrage mit einer Übersichtszusammenfassung
In diesem Beispiel gibt „Text Search“ nur die Zusammenfassung overview für scharf vegetarische Restaurants in Mountain View, Kalifornien, zurück:
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
Die Antwort enthält das Feld generativeSummary.overview mit overview.text und 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"
}
}
},
. . .
}
Beispiel für eine Anfrage mit einer Übersicht und Beschreibung
In diesem Beispiel wird dieselbe Abfrage wie im vorherigen Beispiel durchgeführt, aber mit der Feldmaske places.generativeSummary wird das gesamte Objekt generativeSummary zurückgegeben, einschließlich der Felder generativeSummary.overview, generativeSummary.description und generativeSummary.references:
{
"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"
},
. . .
}
Zusammenfassung der KI-generierten Bereiche anfordern
Bereichszusammenfassungen sind generative Zusammenfassungen, die vom LLM für den nahe gelegenen Bereich eines Orts erstellt werden. Zusammenfassungen von Bereichen können für Nutzer wichtig sein, wenn sie eine Entscheidung zu einem Ort treffen möchten.
Beispiel: Sie möchten ein Hotel in einer neuen Stadt buchen und finden ein Hotel, das Ihren Anforderungen entspricht, möchten aber auch mehr über die Gegend um das Hotel herum erfahren. Anstatt sich eine Karte der Umgebung anzusehen und dann jeden Ort auf der Karte untersuchen zu müssen, können Sie eine Zusammenfassung des Gebiets für das Hotel erstellen.
Zusammenfassungen von Gebieten werden von Place Details (New), Text Search (New) und Nearby Search (New) unterstützt.
Fügen Sie in die Feldmaske der Anfrage Folgendes ein, um die Bereichszusammenfassung in die Antwort aufzunehmen:
areaSummary(Ortsdetails)places.areaSummary(Text Search und Nearby Search).
Das Feld areaSummary für einen Ort in der Antwort enthält ein Array mit bis zu vier contentBlocks.
Das Thema der einzelnen Blöcke richtet sich nach dem Typ des Ortes:
Für eine Ladestation für Elektrofahrzeuge (Ort des Typs
electric_vehicle_charging_station) umfassen die Themenblöcke"overview","coffee","restaurant"und"store".Für einen Ort mit einem durch die Kategorie Unterkünfte definierten Typ und die spezifischen Ortstypen
geocodeundpremiseumfassen die Themenblöcke"overview","activity","restaurant"und"store".
Beispielanfrage für eine Zusammenfassung der Fläche einer Ladestation für Elektrofahrzeuge
In diesem Beispiel für eine „Place Details“-Anfrage wird die Gebietszusammenfassung für eine bestimmte Ladestation für Elektrofahrzeuge in Mountain View zurückgegeben, die durch die Orts-ID ChIJC5b6QKiwj4ARgn2EwlnJnWU identifiziert wird:
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
Die Antwort enthält das Feld areaSummary, einschließlich des Arrays contentBlocks:
Im Feld
topicwird die Art des Inhaltsblocks angegeben. Da der Ort in diesem Beispiel eine Ladestation für Elektrofahrzeuge ist, sind die vier Inhaltsblöcke"overview","coffee","restaurant"und"store".Das Feld
contententhält die Zusammenfassung für dieses Thema, einschließlich des Sprachcodes.Das Array
referencesgibt die Ressourcennamen des Orts im Formatplaces/PLACE_IDan, mit denen Inhalte für den Inhaltsblock angegeben werden.
{
"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"
]
}
}
]
}
}
Beispiel für eine Anfrage nach einer Zusammenfassung der Region für ein Hotel
In diesem Beispiel für eine Text Search-Anfrage werden Hotels in Mountain View, Kalifornien, USA, angefordert:
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
Die Antwort enthält das Feld areaSummary, einschließlich des Arrays contentBlocks. Die Antwort für Orte vom Typ „Hotel“ enthält Inhaltsblöcke für die Themen "overview", "activity", "restaurant" und "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"
]
}
}
]
}
},
...
]
}
Kontextbezogene Suchergebnisse anfordern
Die Antwort auf eine Text Search (New)-Anfrage enthält ein Array von Orten, die den Kriterien des eingegebenen Suchstrings entsprechen. Jetzt können Sie Daten für die kontextbezogene Suche in der Antwort basierend auf der Eingabeabfrage an die API anfordern.
Damit kontextbezogene Zusammenfassungen unterstützt werden, enthält die Antwort von Text Search (New) ein neues Array mit dem Namen contextualContents auf derselben Ebene wie das Array places in der Antwort:
{
"places": [],
"contextualContents":[]
}
Jedes Element im contextualContents-Array vom Typ ContextualContent befindet sich an der entsprechenden Stelle im Array places. Das heißt, das Element bei contextualContents[0] entspricht dem Ort unter places[0].
Jedes Array-Element enthält die folgenden Array-Felder:
contextualContents.reviews: Ein Array mit bis zu drei Rezensionen.contextualContents.photos: ein Array von bis zu fünf Fotos.contextualContents.justifications: ein Array mit Begründungen für den Ort, darunter:reviewJustification: Hebt einen Abschnitt einer Nutzerrezension hervor, der für den Endnutzer interessant sein könnte.businessAvailabilityAttributesJustification: Umfasst Attribute für ein Unternehmen, die für Endnutzer von Interesse sein könnten.
Fügen Sie contextualContents in die Feldmaske der „Text Search (New)“-Anfrage ein, um die kontextbezogenen Suchergebnisse in die Antwort aufzunehmen:
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
Die Antwort enthält das Array contextualContents für jeden Ort der Antwort:
{
"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
}
}
]
},
. . .
]
}
Implementierungsleitfaden für Anwendungsfälle der Automobilbranche
Für die Fahrersicherheit empfiehlt Google, Zusammenfassungen basierend auf generativer KI für die Nutzung in der Automobilindustrie im geparkten Modus zu rendern. Wenn Sie Zusammenfassungen im Fahrmodus rendern, sollten die Informationen auf dem Bildschirm einfach, klar und prägnant sein, damit der Fahrer schnell wieder auf die Straße aufmerksam wird.
- Nicht mehr als 3 Zeilen
- Maximal 120 Zeichen oder 24 Wörter
- Mindestgröße der Vorderseite: 24 dp
Insbesondere im Automobilbereich liegt es in der Verantwortung des Entwicklers, Zusammenfassungen basierend auf generativer KI so zu rendern, dass sie sicher sind und allen lokalen Gesetzen und Bestimmungen entsprechen.
Attribution
Wenn Sie Rezensionen, Fotos und Zusammenfassungen mit generativer KI in Ihrer App anzeigen, einschließlich der Zusammenfassungen von Orten und Gebieten, müssen Sie auch die erforderlichen Quellenangaben anzeigen.
Quellenangaben für generative Zusammenfassungen anzeigen
Wenn Sie Zusammenfassungen von generativer KI in Ihrer App anzeigen, einschließlich der Zusammenfassungen von Orten und Gebieten, müssen Sie auch die erforderlichen Attributionen anzeigen. In diesem Abschnitt wird beschrieben, wie Attributionen auf Grundlage der Darstellung der Zusammenfassungen von Generative AI in Ihrer App angezeigt werden.
In allen Fällen muss für die Quellenangabe die korrekte Groß- und Kleinschreibung des Satzes verwendet werden. Die Quellenangabe und das Google-Logo müssen allen Farb-, Stil- und Schriftartstandards entsprechen. Weitere Informationen zu diesen Standards finden Sie unter Richtlinien für die Places API (New).
Zusammenfassung der generativen KI, die im Kontext anderer Google-Daten angezeigt wird
In diesem Fall kann die Generative AI-Attribution allein über oder unter der Zusammenfassung angezeigt werden, wobei Google die Inhalte an anderer Stelle als Quelle angibt.
Verwenden Sie für die Quellenangabe den Text „Durch KI zusammengefasst“, wie in dieser Abbildung dargestellt:
Zusammenfassung der generativen KI isoliert angezeigt
Wenn eine Zusammenfassung mit generativer KI isoliert von anderen Inhalten aus Google Maps angezeigt wird, muss sie sowohl die Generative AI-Attribution als auch die Attribution an Google durch einen Punkt getrennt enthalten. Verwende für die Attribution den Text „Summarized by AI“ und das Google-Logo, wie in dieser Abbildung dargestellt:
Zusammenfassung der generativen KI in einer Liste wiederholt
Wenn Sie eine Ortszusammenfassung einer generativen KI in einer Liste von Orten wiederholen, wobei alle:
- Listeninhalt ist Google zugeordnet
- Die angezeigten Zusammenfassungen sind KI-generiert
- Inhalte sind bei Google verfügbar
Die Quellenangabe sollte in einer Zeile oberhalb oder unterhalb der Liste angezeigt werden. Die KI-Attribution ist linksbündig und die Google-Attribution ist rechtsbündig:
Wenn längere Zusammenfassungen von Beschreibungen für Generative AI in einer Liste verwendet werden, muss jede Zusammenfassung KI-Attribution („Summarized by AI“ mit dem Infosymbol bzw. der Schaltfläche) haben.
Informationen zu einer Zusammenfassung mit generativer KI in einem Dialogfeld anzeigen
Neben einer Zusammenfassung mit generativer KI müssen Sie Endnutzern ein Dialogfeld mit Informationen zur Zusammenfassung sowie einen Link zum Melden von Problemen zur Verfügung stellen. Wenn Sie eine Zusammenfassung der Beschreibung mit generativer KI verwenden, müssen Sie Informationen über die Quellen der Zusammenfassung angeben, sogenannte references.
Ermöglichen Sie den Zugriff auf dieses Dialogfeld, indem Sie ein Infosymbol (als Interaktivitätsprogramm) in Verbindung mit KI-Attribution einfügen (wie in den obigen Beispielen dargestellt) und den KI-Attributionsbereich und das KI-Symbol auf ein Drücken/Klicken reagieren lassen.
Zeige für KI-generierte Ortszusammenfassungen Folgendes an:
| Info | KI-generierte Ortszusammenfassungen werden aus Google-Rezensionen und anderen Daten generiert. |
| Problem melden | Wenn Sie Google ein Problem mit dem Inhalt einer Zusammenfassung melden möchten, klicken Sie auf diesen Link. |
| Verweise | Quellenrezensionen |
Beispiel:
Für Zusammenfassungen generierter Bereiche Folgendes anzeigen:
| Info | KI-generierte Gebietszusammenfassungen werden anhand von Google-Rezensionen und lokalen Daten generiert. |
| Problem melden | Wenn Sie Google ein Problem mit dem Inhalt einer Zusammenfassung melden möchten, klicken Sie auf diesen Link. |
