KI-basierte Ortszusammenfassungen sind kurze, 100 Zeichen lange Übersichten, die sich auf eine bestimmte Orts-ID beziehen. In Ortszusammenfassungen werden viele verschiedene Datentypen zu einer allgemeinen Übersicht zusammengefasst, damit Nutzer einen schnellen Überblick über einen Ort erhalten.
In Ortszusammenfassungen können beispielsweise beliebte Speisen, Dienstleistungen oder Waren hervorgehoben werden, die an einem Ort erhältlich sind:
- „Restaurant in den Forum Shops mit großen Portionen traditioneller italienischer Gerichte in ungezwungener Atmosphäre.“
- „Stilvoller Salon, der Haarschnitte, Colorationen und Föhnfrisuren anbietet.“
- „Großes Geschäft mit vielen Anbietern, die eine Vielzahl von Vintage-Dekor, ‑Möbeln und ‑Kleidung anbieten.“
Ortszusammenfassungen werden von Place Details (New), Text Search (New) und Nearby Search (New) unterstützt. Ortszusammenfassungen sind für die Ortstypen verfügbar, die unter Unterstützte Typen für die Kategorien Kultur, Unterhaltung und Freizeit, Essen und Trinken, Shopping, Dienstleistungen und Sport aufgeführt sind.
Ortszusammenfassungen werden für POIs in den folgenden Sprachen und Regionen unterstützt:
| Sprache | Region |
|---|---|
| Englisch |
Australien Kanada Indien Neuseeland Singapur USA |
Generative Zusammenfassung eines Ortes anfordern
Wenn Sie eine Ortszusammenfassung in der Antwort zurückgeben möchten, fügen Sie das folgende Feld in die Feldmaske der Anfrage ein:
- Place Details (New):
generativeSummary - Text Search (New) und Nearby Search (New):
places.generativeSummary
Das Feld generativeSummary enthält die folgenden Felder:
generativeSummary: Die Zusammenfassung des Ortes.overviewFlagContentUri: Ein Link, über den Nutzer ein Problem mit der Ortszusammenfassung melden können.disclosureText: Ein lokalisierter Textstring mit dem Offenlegungstext „Zusammengefasst mit Gemini“, der in Quellenangaben enthalten sein muss.
Place Details (New)-Anfrage
Die folgende „Place Details (New)“-Anfrage gibt eine overview-Zusammenfassung für ein Sushi-Restaurant in Chicago, Illinois, zurück:
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"
Die Antwort hat folgendes Format:
{ "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)-Anfrage
Mit der folgenden Text Search (New)-Anfrage wird eine overview-Zusammenfassung für scharfe vegetarische Restaurants in Mountain View, Kalifornien, zurückgegeben:
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'
Die Antwort hat folgendes Format:
{ "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 (New)-Anfrage
Die folgende Nearby Search (New)-Anfrage gibt eine overview-Zusammenfassung für Restaurants und Cafés in Portland, Oregon, zurück:
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'
Die Antwort hat folgendes Format:
{ "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" } } }, /.../ ] }
Attribution
Alle KI-basierten Zusammenfassungen, die in Ihrer App angezeigt werden, müssen gemäß den Richtlinien und Standards von Google mit der entsprechenden Quellenangabe versehen sein. Weitere Informationen finden Sie unter Richtlinien für die Places API.