KI-basierte Ortszusammenfassungen

KI-gestützte Ortszusammenfassungen sind kurze, 100-stellige Übersichten, die sich auf eine bestimmte Orts-ID beziehen. In Ortszusammenfassungen werden viele verschiedene Datentypen in einer allgemeinen Übersicht zusammengefasst, damit Nutzer einen Überblick über einen Ort erhalten.

In Ortszusammenfassungen können beispielsweise beliebte Gerichte, Dienstleistungen oder Waren hervorgehoben werden, die an einem Ort gekauft werden können:

  • „Restaurant in den Forum Shops, das traditionelle italienische Gerichte in großen Portionen in ungezwungener Atmosphäre serviert.“
  • „Stylisher Salon, der Haarschnitte, Färbungen und Blowouts anbietet.“
  • „Großer Laden mit vielen Händlern, die eine Vielzahl von Vintage-Dekorationsartikeln, -Möbeln und -Kleidung anbieten.“

Ortszusammenfassungen werden von Place Details (New), Text Search (New) und Nearby Search (New) unterstützt. Ortszusammenfassungen sind für Ortstypen verfügbar, die in den unterstützten Typen für die Kategorien Kultur, Unterhaltung und Erholung, Essen und Trinken, Shopping,Dienstleistungen und Sport aufgeführt sind.

Generative Ortszusammenfassung anfordern

Wenn Sie in der Antwort eine Ortsübersicht 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 Ortsübersicht.
  • overviewFlagContentUri: Ein Link, über den Nutzer Probleme mit der Ortsübersicht melden können.
  • disclosureText: Ein lokalisierter Textstring mit dem Hinweis „Mit Gemini zusammengefasst“, der in die Quellenangaben eingefügt werden muss.

Anfrage vom Typ „Place Details (New)“

Die folgende „Place Details (New)“-Anfrage gibt eine overview-Zusammenfassung für ein Sushi-Restaurant 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"
    }
  }
}

Anfrage für „Text Search (New)“

Die folgende Anfrage vom Typ „Text Search (New)“ 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"
        }
      }
    },
    /.../
  ]
}

Anfrage für Nearby Search (New)

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 entsprechend gekennzeichnet sein. Weitere Informationen finden Sie unter Richtlinien für die Places API.