La API de Places muestra información sobre un lugar en una respuesta. Además del contenido fáctico, como una dirección y un número de teléfono, la respuesta también puede contener contenido que los usuarios hayan agregado en Google Maps, como opiniones y fotos. Además, cuando usas las funciones del modelo de Gemini para la API de Places, la respuesta puede incluir datos generativos agregados y resumidos a partir de un LLM.
Si bien Google implementó una serie de medidas para identificar contenido problemático antes de que la API de Places lo muestre, también proporcionamos una forma para que los usuarios marquen contenido inapropiado para que Google pueda quitarlo. Con esta versión, la API de Places incluye el nuevo campo flagContentUri en todas las opiniones, fotos y resúmenes generativos incluidos en una respuesta de la API de Places. Este campo contiene un vínculo, incluido un identificador de contenido único, que permite a los usuarios notificar a Google sobre contenido inapropiado.
Por ejemplo, realizas una solicitud que muestra cinco opiniones individuales de un lugar. Cada opinión individual incluye el nuevo campo flagContentUri con un identificador único para esa opinión, de modo que un usuario pueda informar un problema con alguna o todas las opiniones.
El Explorador de APIs te permite realizar solicitudes en vivo para que te familiarices con estas nuevas opciones:
Formato de vínculo
La URL contenida en el campo flagContentUri incluye un identificador único para el contenido. Si navegas a este vínculo, se abrirá una página web alojada por Google con el siguiente formato:
Desde este diálogo, los usuarios pueden presentar un informe a Google sobre el tipo de problema correspondiente. Por ejemplo, pueden denunciar lenguaje obsceno, acoso o un problema legal con el contenido.
Precios
Esta función se encuentra en la etapa de vista previa previa a la DG y no se cobra por su uso durante la vista previa, es decir, la facturación es de USD 0. Para obtener detalles sobre los precios propuestos, consulta Uso y facturación de la API de Places.
Cómo mostrar el vínculo para denunciar contenido
Esta versión preliminar agrega el nuevo campo flagContentUri a los siguientes objetos que ya forman parte de la respuesta de la API de Places:
ReviewPhotoGenerativeSummarySolo paraGenerativeSummary, hay dos campos nuevos:overviewFlagContentUri: Es el vínculo para notificar a Google sobre contenido inapropiado en la descripción general.descriptionFlagContentUri: Es el vínculo para notificar a Google sobre el contenido inapropiado en la descripción.
Durante el período de la versión preliminar, no es necesario que muestres el vínculo de informes de contenido cuando muestres estos objetos a tus clientes.
Sin embargo, cuando esta función pase a la etapa de disponibilidad general (DG), debes mostrar el vínculo de informes de contenido cuando muestres estos objetos para que tus clientes puedan informar cualquier problema relacionado.
Accede al vínculo de los informes de contenido en la respuesta
La siguiente solicitud de Place Details incluye opiniones de lugares en la respuesta:
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 respuesta tiene el siguiente 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"
},
…
]
}
Cada entrada del array reviews contiene el campo flagContentUri, que incluye un identificador único para esa opinión específica. Si navegas a ese vínculo, tus clientes podrán denunciar contenido inapropiado en esa opinión específica.
Si incluyes photos en la máscara de campo, haz lo siguiente:
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 respuesta también incluye el array photos, en el que cada elemento contiene el 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"
},
...
]
Vencimiento del vínculo
Los vínculos de contenido permanecen activos hasta que se quita el contenido de respaldo. Los vínculos siguen abriendo el diálogo del contenido que se quitó, pero presentar un informe sobre contenido que ya se quitó no tiene ningún efecto.
Pruébalo
El Explorador de API te permite realizar solicitudes de muestra para que te familiarices con la API y sus opciones.
Selecciona el ícono de API,
, en el lado derecho
de la página.De manera opcional, expande Mostrar parámetros estándar y establece el parámetro
fieldsen la máscara de campo.De manera opcional, edita el Cuerpo de la solicitud.
Selecciona el botón Ejecutar. En el cuadro de diálogo, elige la cuenta que deseas usar para realizar la solicitud.
En el panel del Explorador de API, selecciona el ícono de expansión,
, para expandir la ventana del Explorador de API.