L'API Places (nouveau) renvoie des informations sur un lieu dans une réponse. En plus du contenu factuel, comme une adresse et un numéro de téléphone, la réponse peut également contenir du contenu que les utilisateurs ont ajouté sur Google Maps, comme des avis et des photos. De plus, lorsque vous utilisez les fonctionnalités du modèle Gemini pour l'API Places (nouveau), la réponse peut inclure des données génératives agrégées et résumées à partir d'un LLM.
Bien que Google ait mis en place une série de mesures pour identifier les contenus problématiques avant qu'ils ne soient renvoyés par l'API Places (New), nous permettons également aux utilisateurs de signaler les contenus inappropriés afin que Google puisse les supprimer. Avec cette version, l'API Places (nouveau) inclut le nouveau champ flagContentUri
dans tous les avis, photos et résumés génératifs inclus dans une réponse de l'API Places (nouveau). Ce champ contient un lien, y compris un identifiant de contenu unique, qui permet aux utilisateurs de signaler à Google du contenu inapproprié.
Par exemple, vous envoyez une requête qui renvoie cinq avis individuels pour un lieu. Chaque avis individuel inclut le nouveau champ flagContentUri
avec un identifiant unique pour cet avis. Ainsi, un utilisateur peut signaler un problème concernant un ou plusieurs avis.
L'API Explorer vous permet d'envoyer des requêtes en temps réel pour vous familiariser avec ces nouvelles options :
Format du lien
L'URL contenue dans le champ flagContentUri
inclut un identifiant unique pour le contenu. Si vous accédez à ce lien, une page Web hébergée par Google s'ouvre au format suivant :
Dans cette boîte de dialogue, vos utilisateurs peuvent envoyer un rapport à Google pour le type de problème approprié. Par exemple, ils peuvent signaler des propos vulgaires, de l'intimidation ou un problème juridique lié au contenu.
Afficher le lien de signalement de contenu
Le champ flagContentUri
est disponible dans les objets suivants qui font déjà partie de la réponse de l'API Places (nouveau) :
Review
Photo
GenerativeSummary
NeighborhoodSummary
EvChargeAmenitySummary
ReviewSummary
ContextualContent
Vous devez afficher le lien de signalement de contenu lorsque vous affichez ces objets afin que vos clients puissent signaler tout problème de contenu.
Accéder au lien de signalement de contenu dans la réponse
La requête Place Details (New) suivante inclut les avis sur le lieu dans la réponse :
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
La réponse se présente sous la forme suivante :
{ "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" }, … ] }
Chaque entrée du tableau reviews
contient le champ flagContentUri
, y compris un identifiant unique pour cet avis spécifique. En accédant à ce lien, vos clients peuvent signaler du contenu inapproprié pour cet avis spécifique.
Si vous incluez photos
dans le masque de champ :
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
La réponse inclut également le tableau photos
, où chaque élément contient le champ flagContentUri
:
... "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" }, ... ]
Expiration du lien
Les liens vers le contenu restent actifs jusqu'à ce que le contenu sous-jacent soit supprimé. Les liens continuent d'ouvrir la boîte de dialogue pour les contenus supprimés, mais le signalement de contenus déjà supprimés n'a aucun effet.
Essayer
API Explorer vous permet d'envoyer des exemples de requêtes pour vous familiariser avec l'API et ses options.
Sélectionnez l'icône API
à droite de la page.
Vous pouvez également développer Afficher les paramètres standards et définir le paramètre
fields
sur le masque de champ.Vous pouvez également modifier le corps de la requête.
Sélectionnez le bouton Exécuter. Dans la boîte de dialogue, choisissez le compte que vous souhaitez utiliser pour envoyer la demande.
Dans le panneau "APIs Explorer", sélectionnez l'icône Développer,
, pour développer la fenêtre "APIs Explorer".