KI-basierte Ortszusammenfassungen

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 einen schnellen Überblick über einen Ort erhalten.

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 Küche 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. Zusammenfassungen von Orten sind für die in Unterstützte Typen aufgeführten Ortstypen für die Kategorien Kultur, Unterhaltung und Freizeit, Essen und Trinken, Shopping, Dienstleistungen und Sport verfügbar.

Ortszusammenfassungen werden für POIs in den folgenden Sprachen und Regionen unterstützt:

Sprache Region
Englisch

Indien

USA

Generative Zusammenfassung eines Orts anfordern

Wenn Sie eine Ortszusammenfassung in der Antwort zurückgeben möchten, fügen Sie das folgende Feld in die Feldmaske der Anfrage ein:

  • Ortsdetails (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 Zusammenfassung des Orts melden können.
  • disclosureText: Ein lokalisierter Textstring mit dem Offenlegungstext „Mit Gemini zusammengefasst“, 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, 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 das folgende 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 das folgende 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 das folgende 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.