A API Places retorna informações sobre um lugar em uma resposta. Além do conteúdo factual, como um endereço e número de telefone, a resposta também pode incluir informações que os usuários forneceram no Google Maps, como avaliações e fotos. Além disso, quando você usa os recursos de modelo Gemini para a API Places, a resposta pode incluir dados generativos agregados e resumidos de um LLM.
Embora o Google tenha implementado uma série de medidas para identificar conteúdo problemático antes que ele seja retornado pela API Places, também oferecemos uma maneira de os usuários sinalizarem conteúdo inadequado para que o Google possa removê-lo. Com essa
versão, a API Places inclui o novo campo flagContentUri
em todas
as avaliações, fotos e resumos generativos incluídos em uma resposta da API
Places. Esse campo contém um link, incluindo um identificador de conteúdo exclusivo,
que permite que os usuários notifiquem o Google sobre conteúdo inadequado.
Por exemplo, você faz uma solicitação que retorna cinco avaliações individuais de um lugar. Cada avaliação individual inclui o novo campo flagContentUri
com um identificador exclusivo para que um usuário possa informar um problema com qualquer uma ou todas as avaliações.
O API Explorer permite fazer solicitações em tempo real para que você se familiarize com estas novas opções:
Formato de link
O URL contido no campo flagContentUri
inclui um identificador exclusivo do
conteúdo. Navegar até este link abre uma página da Web hospedada pelo Google no formulário:
Nessa caixa de diálogo, os usuários podem enviar um relatório ao Google para o tipo de problema adequado. Por exemplo, eles podem denunciar linguagem obscena, bullying ou uma questão legal com o conteúdo.
Preços
Esse recurso está na fase de pré-lançamento e não tem cobrança. Isso significa que o faturamento é de US $0,00 para o uso durante a fase de pré-lançamento. Para detalhes sobre os preços propostos, consulte Uso e faturamento da API Places.
Mostrar o link de denúncia de conteúdo
Esta versão de pré-lançamento adiciona o novo campo flagContentUri
aos seguintes objetos que já fazem parte da resposta da API Places:
Review
Photo
GenerativeSummary
ParaGenerativeSummary
, há dois novos campos:overviewFlagContentUri
: o link para notificar o Google sobre conteúdo inapropriado na visão geral.descriptionFlagContentUri
: o link para notificar o Google sobre conteúdo inadequado na descrição.
Durante o período de visualização, não é necessário exibir o link de relatórios de conteúdo ao mostrar esses objetos aos clientes.
No entanto, quando esse recurso estiver em disponibilidade geral (GA), você precisará mostrar o link de relatórios de conteúdo ao mostrar esses objetos para que os clientes possam informar problemas de conteúdo.
Acessar o link de denúncia de conteúdo na resposta
A solicitação de Place Details a seguir inclui avaliações de lugares na resposta:
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
A resposta está no 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 na matriz reviews
contém o campo flagContentUri
,
incluindo um identificador exclusivo para essa revisão específica. Ao acessar esse link,
os clientes podem denunciar conteúdo inadequado para essa avaliação específica.
Se você incluir photos
na máscara de 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
A resposta também inclui a matriz photos
, em que cada elemento contém o
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" }, ... ]
Expiração do link
Os links de conteúdo permanecem ativos até que o conteúdo de origem seja removido. Os links continuam a abrir a caixa de diálogo para conteúdo removido, mas o envio de um denúncia sobre conteúdo que já foi removido não tem efeito.
Confira!
O API Explorer permite fazer solicitações de amostra para que você se familiarize com a API e as opções dela.
Selecione o ícone da API, , no lado direito da página.
Opcionalmente, abra Mostrar parâmetros padrão e defina o parâmetro
fields
como a máscara de campo.Se preferir, edite o corpo da solicitação.
Selecione o botão Executar. Na caixa de diálogo, escolha a conta que você quer usar para fazer a solicitação.
No painel do API Explorer, selecione o ícone de expansão para abrir a janela do API Explorer.