KI-basierte Ortszusammenfassungen sind kurze Übersichten mit maximal 100 Zeichen, die sich auf eine bestimmte Orts-ID beziehen. In Ortszusammenfassungen werden viele verschiedene Arten von Daten in einer Übersicht zusammengefasst, damit Nutzer sich einen schnellen Überblick über einen Ort verschaffen können.
In Ortszusammenfassungen können beispielsweise beliebte Speisen, Dienstleistungen oder Waren hervorgehoben werden, die an einem Ort zum Kauf angeboten werden:
- „Restaurant in den Forum Shops mit großen Portionen traditioneller italienischer Gerichte in einem zwanglosen Ambiente.“
- „Stilvoller Salon mit Haarschnitten, Colorationen und Föhnen.“
- „Großes Geschäft mit vielen Anbietern, die eine Vielzahl von Vintage-Dekoration, 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,Dienste und Sport aufgeführt sind.
Ortszusammenfassungen werden für POIs in den folgenden Sprachen und Regionen unterstützt:
| Sprache | Region |
|---|---|
| Englisch |
Indien USA |
KI-Zusammenfassung eines Orts anfordern
Wenn Sie eine Zusammenfassung des Orts in der Antwort zurückgeben möchten, fügen Sie das folgende Feld in die Feldmaske der Anfrage ein:
- Place Details (Neu):
generativeSummary - Text Search (New) und Nearby Search (New):
places.generativeSummary
Das Feld generativeSummary enthält die folgenden Felder:
generativeSummary: Die Zusammenfassung des Orts.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 Sushirestaurant in Chicago, IL, 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
Die folgende Text Search (New)-Anfrage gibt eine overview-Zusammenfassung für scharfe 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" \
'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
Mit der folgenden Nearby Search (New)-Anfrage wird eine overview-Zusammenfassung für Restaurants und Cafés in Portland, Oregon, zurückgegeben:
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 werden. Weitere Informationen finden Sie unter Richtlinien für die Places API.