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 auf 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. So können Nutzer ein Problem mit einer oder allen Rezensionen melden.
Mit dem API Explorer können Sie Live-Anfragen stellen, damit Sie sich mit den neuen Optionen vertraut machen können:
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:
In diesem Dialogfeld können Ihre Nutzer die entsprechende Art des Problems bei Google melden. 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:
Review
Photo
GenerativeSummary
Nur fürGenerativeSummary
gibt 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.
Wenn diese Funktion jedoch allgemein verfügbar ist, muss beim Anzeigen dieser Objekte der Link zum Melden von Inhalten eingeblendet werden, damit Ihre Kunden Probleme mit dem Inhalt melden können.
Auf den Link zum Melden von Inhalten in der Antwort zugreifen
Die folgende „Place Details“-Anfrage 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 das folgende 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. Wenn Sie diesen Link aufrufen, 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.
Optional können Sie Standardparameter anzeigen maximieren und den Parameter
fields
auf die Feldmaske festlegen.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.