Die Places API gibt in einer Antwort Informationen zu einem Ort zurück. Neben sachlichen Inhalten wie einer Adresse und Telefonnummer kann die Antwort auch von Nutzern bei Google Maps erstellte Inhalte enthalten, z. B. Rezensionen und Fotos. Wenn Sie die Gemini-Modellfunktionen für die Places API verwenden, kann die Antwort außerdem generative Daten enthalten, die aus einem LLM aggregiert und zusammengefasst wurden.
Google hat eine Reihe von Maßnahmen ergriffen, um problematische Inhalte zu erkennen, bevor sie von der Places API zurückgegeben werden. Nutzer können aber auch unangemessene Inhalte melden, damit Google sie entfernen kann. Mit dieser Version enthält die Places API das neue Feld flagContentUri in allen Rezensionen, Fotos und generativen Zusammenfassungen, die in einer Places API-Antwort enthalten sind. Dieses Feld enthält einen Link mit einer eindeutigen Inhalts-ID, über den Nutzer Google auf unangemessene Inhalte hinweisen können.
Sie stellen beispielsweise eine Anfrage, die fünf einzelne Rezensionen für einen Ort zurückgibt. Jede einzelne Rezension enthält das neue Feld flagContentUri mit einer eindeutigen Kennung für diese Rezension, damit ein Nutzer ein Problem mit einer oder allen Rezensionen melden kann.
Im API Explorer können Sie Liveanfragen stellen, um sich mit diesen neuen Optionen vertraut zu machen:
Linkformat
Die im Feld flagContentUri enthaltene URL enthält eine eindeutige Kennzeichnung für den Inhalt. Wenn Sie diesen Link aufrufen, wird eine von Google gehostete Webseite in folgendem Format geöffnet:
Über dieses Dialogfeld können Ihre Nutzer bei Google einen Bericht zum entsprechenden Problemtyp einreichen. Sie können beispielsweise vulgäre Sprache, Mobbing oder rechtliche Probleme mit den Inhalten melden.
Preise
Diese Funktion befindet sich in der Pre-GA-Vorabversion und ist kostenlos. Das bedeutet, dass für die Nutzung während der Vorabversion keine Kosten anfallen. Weitere Informationen zu den vorgeschlagenen Preisen finden Sie unter Places API – Nutzung und Abrechnung.
Link zum Melden von Inhalten anzeigen
In dieser Vorabversion wird das neue Feld flagContentUri den folgenden Objekten hinzugefügt, die bereits Teil der Places API-Antwort sind:
ReviewPhotoGenerativeSummaryNur fürGenerativeSummarygibt es zwei neue Felder:overviewFlagContentUri: Der Link, über den Sie Google über unangemessene Inhalte in der Übersicht informieren können.descriptionFlagContentUri: Der Link, über den du Google auf unangemessene Inhalte in der Beschreibung aufmerksam machen kannst.
Während der Vorabversion müssen Sie den Link zur Meldung von Inhalten nicht anzeigen, wenn Sie diese Objekte Ihren Kunden präsentieren.
Sobald diese Funktion allgemein verfügbar ist, müssen Sie den Link zum Melden von Inhalten anzeigen, wenn Sie diese Objekte präsentieren, damit Ihre Kunden Probleme mit Inhalten melden können.
Über den Link in der Antwort auf die Meldefunktion für Inhalte zugreifen
Die folgende Anfrage vom Typ „Place Details“ enthält Rezensionen zu Orten in der Antwort:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,reviews" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Die Antwort hat folgendes Format:
{
"id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
"displayName": {
"text": "Googleplex",
"languageCode": "en"
},
"reviews": [
{
"name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/ChdDjNnRRAB",
"relativePublishTimeDescription": "7 months ago",
"rating": 3,
"text": {
"text": "Came here for a tour and honestly,...",
"languageCode": "en"
},
"originalText": {
"text": "Came here for a tour and honestly,...",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "John Smith",
"uri": "https://www.google.com/maps/contrib/10198693/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/A-c00-cc-rp-mo-ba6"
},
"publishTime": "2024-02-24T19:26:18.091264Z",
"flagContentUri": "https://www.google.com/local/review/rap/report?postId=CJ2&t=1",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5"
},
…
]
}
Jeder Eintrag im Array reviews enthält das Feld flagContentUri mit einer eindeutigen Kennung für die jeweilige Rezension. Über diesen Link können Ihre Kunden unangemessene Inhalte für diese bestimmte Rezension melden.
Wenn Sie photos in die Feldmaske aufnehmen:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,reviews,photos" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Die Antwort enthält auch das photos-Array, in dem jedes Element das Feld flagContentUri enthält:
...
"photos": [
{
"name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/AdCG2DNmA4zTnu24VKCwSW7ulKkgDA8cTe5sz74Q4Doo",
"widthPx": 4032,
"heightPx": 3024,
"authorAttributions": [
{
"displayName": "Jane Smith",
"uri": "https://maps.google.com/maps/contrib/107007354",
"photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjXvHp8Kg932h80MpoDSJ_Sl4F-no-mo"
}
],
"flagContentUri": "https://www.google.com/local/imagery/report/?cb_client=maps_api_places&image_key=!1e10!2XtMU_GKr",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5"
},
...
]
Ablauf des Links
Die Inhaltslinks bleiben aktiv, bis die zugrunde liegenden Inhalte entfernt werden. Über die Links wird weiterhin das Dialogfeld für entfernte Inhalte geöffnet. Das Melden von bereits entfernten Inhalten hat jedoch keine Auswirkungen.
Testen!
Mit dem API Explorer können Sie Beispielanfragen senden, um sich mit der API und den API-Optionen vertraut zu machen.
Wählen Sie rechts auf der Seite das API-Symbol
aus.Maximieren Sie optional Standardparameter anzeigen und legen Sie den Parameter
fieldsauf die Feldmaske fest.Optional können Sie den Anfragetext bearbeiten.
Klicken Sie auf die Schaltfläche Ausführen. Wählen Sie im Dialogfeld das Konto aus, mit dem Sie die Anfrage stellen möchten.
Klicken Sie im API Explorer-Steuerfeld auf das Symbol zum Maximieren
, um das Fenster des API Explorers zu maximieren.