L'API Places renvoie des informations sur un lieu dans une réponse. En plus des informations factuelles, telles qu'une adresse et un numéro de téléphone, la réponse peut également contenir des contenus que les utilisateurs ont ajoutés 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, 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, nous permettons également aux utilisateurs de signaler les contenus inappropriés afin que Google puisse les supprimer. Avec cette version, l'API Places 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. Ce champ contient un lien, y compris un identifiant de contenu unique, qui permet aux utilisateurs de signaler à Google un contenu inapproprié.
Par exemple, vous envoyez une requête qui renvoie cinq avis individuels pour un établissement. Chaque avis individuel inclut le nouveau champ flagContentUri avec un identifiant unique pour cet avis afin qu'un utilisateur puisse signaler un problème avec l'un ou l'ensemble des avis.
API Explorer vous permet d'envoyer des requêtes en direct afin de 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 cliquez sur ce lien, une page Web hébergée par Google s'ouvre sous la forme suivante:
Dans cette boîte de dialogue, vos utilisateurs peuvent signaler le problème approprié à Google. Par exemple, ils peuvent signaler un contenu contenant des jurons, de l'intimidation ou un problème juridique.
Tarifs
Cette fonctionnalité est en phase de pré-disponibilité générale et son utilisation est sans frais pendant la phase de preview (facturation de 0 $). Pour en savoir plus sur les tarifs proposés, consultez la page Utilisation et facturation de l'API Places.
Afficher le lien de signalement de contenu
Cette version Preview ajoute le nouveau champ flagContentUri aux objets suivants qui font déjà partie de la réponse de l'API Places:
ReviewPhotoGenerativeSummaryPourGenerativeSummaryuniquement, deux nouveaux champs sont disponibles:overviewFlagContentUri: lien permettant de signaler à Google un contenu inapproprié dans la vue d'ensemble.descriptionFlagContentUri: Lien permettant de signaler à Google un contenu inapproprié dans la description.
Pendant la période de preview, vous n'êtes pas tenu d'afficher le lien de signalement de contenu lorsque vous présentez ces objets à vos clients.
Toutefois, lorsque cette fonctionnalité sera disponible en disponibilité générale, vous devrez afficher le lien de signalement de contenu lorsque vous afficherez 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 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 est au format suivant:
{
"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 un 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 de base soit supprimé. Les liens continuent d'ouvrir la boîte de dialogue pour le contenu qui a été supprimé, mais le fait de signaler un contenu déjà supprimé n'a aucun effet.
Essayer
API Explorer vous permet d'envoyer des exemples de requêtes afin de vous familiariser avec l'API et ses options.
Sélectionnez l'icône API
sur le côté droit de la page.Vous pouvez également développer Afficher les paramètres standards et définir le paramètre
fieldssur le masque de champ.Modifiez éventuellement le corps de la requête.
Sélectionnez le bouton Execute (Exécuter). Dans la boîte de dialogue, sélectionnez le compte que vous souhaitez utiliser pour effectuer la demande.
Dans le panneau API Explorer, sélectionnez l'icône de développement,
, pour développer la fenêtre API Explorer.