Die Places API gibt Informationen zu einem Ort in einer Antwort 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 implementiert, 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 Kennung 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 für den entsprechenden Problemtyp einreichen. Sie können beispielsweise vulgäre Sprache, Mobbing oder ein rechtliches Problem mit den Inhalten melden.
Preise
Diese Funktion befindet sich in der Vorabversion vor der allgemeinen Verfügbarkeit. Die Nutzung während der Vorabversion ist kostenlos. Weitere Informationen zu den vorgeschlagenen Preisen finden Sie unter Nutzung und Abrechnung der Google Places API.
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 auf unangemessene Inhalte in der Übersicht hinweisen können.descriptionFlagContentUri: Der Link, über den Google über unangemessene Inhalte in der Beschreibung informiert werden kann.
Während der Vorabversion müssen Sie den Link zum Melden 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 Inhalte melden können.
Über den Link in der Antwort auf die Meldefunktion für Inhalte zugreifen
Die folgende Places Details-Anfrage enthält Rezensionen zu einem Ort 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 reviews-Array enthält das Feld flagContentUri mit einer eindeutigen Kennung für diese bestimmte Rezension. Über diesen Link können Ihre Kunden unangemessene Inhalte für diese 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 bereits entfernter Inhalte hat jedoch keine Auswirkungen.
Testen!
Mit dem API Explorer können Sie Beispielanfragen stellen, 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
fieldsauf 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.