KI-basierte Ortszusammenfassungen

KI-gestützte Ortszusammenfassungen sind kurze, 100 Zeichen umfassende Übersichten, die sich auf eine bestimmte Orts-ID beziehen. In Ortszusammenfassungen werden viele verschiedene Arten von Daten 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 zum Kauf angeboten werden:

  • „Restaurant in den Forum Shops mit großen Portionen traditioneller italienischer Gerichte in ungezwungenem Ambiente.“
  • „Stylischer Salon mit Haarschnitten, Colorationen und Föhnfrisuren.“
  • „Großes Geschäft mit vielen Anbietern, die eine Vielzahl von Vintage-Dekorationen, 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 Points of Interest in den folgenden Sprachen und Regionen unterstützt:

Sprache Region
Englisch

Indien

USA

Generative Ortszusammenfassung anfordern

Wenn in der Antwort eine Ortszusammenfassung zurückgegeben werden soll, fügen Sie in der Feldmaske der Anfrage das folgende Feld ein:

  • Place Details (New) : generativeSummary
  • Text Search (New) und Nearby Search (New) : places.generativeSummary

Das Feld „ generativeSummary “ enthält die folgenden Felder:

  • generativeSummary: Die Ortszusammenfassung.
  • 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 die Attributionen aufgenommen werden 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 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

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-gestützten Zusammenfassungen, die in Ihrer App angezeigt werden, müssen gemäß den Richtlinien und Standards von Google die entsprechende Attribution enthalten. Weitere Informationen finden Sie unter Richtlinien für die Places API.