A API Places retorna informações sobre um lugar em uma resposta. Além de conteúdo factual, como endereço e número de telefone, a resposta também pode conter conteúdo que os usuários enviaram 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 essa avaliação. Assim, um usuário pode 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. Ao clicar nesse link, uma página da Web hospedada pelo Google é aberta no formato:
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, ou seja, o faturamento é de US $0,00, para uso durante a fase de pré-lançamento. Para detalhes sobre o preço proposto, 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:
ReviewPhotoGenerativeSummaryParaGenerativeSummary, há dois novos campos:overviewFlagContentUri: o link para notificar o Google sobre conteúdo inadequado 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 for lançado para todos os usuários, você precisará mostrar o link de denúncia de conteúdo ao exibir esses objetos para que os clientes possam denunciar 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"
},
...
]
Prazo de validade 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
fieldscomo 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.