L'API Places restituisce informazioni su un luogo in una risposta. Oltre ai contenuti fattuali, come un indirizzo e un numero di telefono, la risposta può anche contenere contenuti che gli utenti hanno contribuito a Google Maps, come recensioni e foto. Inoltre, quando utilizzi le funzionalità del modello Gemini per l'API Places, la risposta può includere dati generativi aggregati e riassunti da un modello LLM.
Sebbene Google abbia implementato una serie di misure per identificare i contenuti problematici prima che vengano restituiti dall'API Places, offriamo anche un modo per consentire agli utenti di segnalare contenuti inappropriati in modo che Google possa rimuoverli. Con questa release, l'API Places include il nuovo campo flagContentUri in tutte le recensioni, le foto e i riepiloghi generativi inclusi in una risposta dell'API Places. Questo campo contiene un link, che include un identificatore univoco dei contenuti, che consente agli utenti di segnalare a Google contenuti inappropriati.
Ad esempio, invii una richiesta che restituisce cinque recensioni singole per un luogo. Ogni singola recensione include il nuovo campo flagContentUri con un identificativo univoco per la recensione in modo che un utente possa segnalare un problema con una o tutte le recensioni.
Explorer API ti consente di effettuare richieste in tempo reale per familiarizzare con queste nuove opzioni:
Formato link
L'URL contenuto nel campo flagContentUri include un identificatore univoco per i contenuti. Se apri questo link, si apre una pagina web ospitata da Google nel seguente formato:
Da questa finestra di dialogo, gli utenti possono inviare una segnalazione a Google per il tipo di problema appropriato. Ad esempio, possono segnalare linguaggio volgare, bullismo o un problema legale correlato ai contenuti.
Prezzi
Questa funzionalità è nella fase di anteprima pre-GA e non prevede alcun costo, il che significa che la fatturazione è pari a 0 $per l'utilizzo durante l'anteprima. Per informazioni dettagliate sui prezzi proposti, consulta Utilizzo e fatturazione dell'API Places.
Mostrare il link per i report sui contenuti
Questa release di anteprima aggiunge il nuovo campo flagContentUri ai seguenti oggetti che fanno già parte della risposta dell'API Places:
ReviewPhotoGenerativeSummarySolo perGenerativeSummary, sono disponibili due nuovi campi:overviewFlagContentUri: il link per segnalare a Google contenuti inappropriati nella panoramica.descriptionFlagContentUri: il link per segnalare a Google contenuti inappropriati nella descrizione.
Durante il periodo di anteprima, non è necessario mostrare il link per i report sui contenuti quando mostri questi oggetti ai tuoi clienti.
Tuttavia, quando questa funzionalità sarà disponibile a livello generale, dovrai mostrare il link per la segnalazione dei contenuti quando mostri questi oggetti in modo che i clienti possano segnalare eventuali problemi relativi ai contenuti.
Accedere al link per i report sui contenuti nella risposta
La seguente richiesta di dettagli dei luoghi include le recensioni dei luoghi nella risposta:
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 risposta è nel seguente formato:
{
"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"
},
…
]
}
Ogni voce dell'array reviews contiene il campo flagContentUri, incluso un identificatore univoco per la recensione specifica. Se aprono il link, i clienti possono segnalare contenuti inappropriati per quella recensione specifica.
Se includi photos nella maschera di campo:
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 risposta include anche l'array photos in cui ogni elemento contiene il campo 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"
},
...
]
Scadenza del link
I link ai contenuti rimangono attivi fino alla rimozione dei contenuti di supporto. I link continuano ad aprire la finestra di dialogo per i contenuti che sono stati rimossi, ma la segnalazione di contenuti già rimossi non ha alcun effetto.
Prova
L'Explorer API ti consente di effettuare richieste di esempio per acquisire familiarità con l'API e le relative opzioni.
Seleziona l'icona dell'API
sul lato
destro della pagina.Se vuoi, espandi Mostra parametri standard e imposta il parametro
fieldssulla maschera del campo.Se vuoi, modifica il corpo della richiesta.
Seleziona il pulsante Esegui. Nella finestra di dialogo, scegli l'account che vuoi utilizzare per effettuare la richiesta.
Nel riquadro di Explorer API, seleziona l'icona di espansione
per espandere la finestra di Explorer API.