Fornecer resumos com tecnologia de IA

Este produto ou recurso é experimental (pré-GA). Os produtos e recursos pré-GA têm suporte limitado, e é possível que as mudanças neles não sejam compatíveis com versões anteriores. As Soluções pré-GA são cobertas pelos Termos de Serviço da Plataforma Google Maps. Para mais detalhes, consulte as descrições da fase de lançamento.

Desenvolvedores do Espaço Econômico Europeu (EEE)

Se seu endereço de faturamento estiver localizado no Espaço Econômico Europeu, a partir de 8 de julho de 2025 seu uso dos serviços estará sujeito aos Termos de Serviço do EEE da Plataforma Google Maps. A funcionalidade varia de acordo com a região. Saiba mais.

**Atenção** :os resumos gerados por IA estão disponíveis apenas para destinos residenciais em algumas regiões metropolitanas dos Estados Unidos e da Índia. A cobertura é limitada a essas áreas e pode ser baixa, especialmente fora dos centros urbanos. Para conferir uma lista de regiões metropolitanas com suporte, consulte Cobertura de destinos.

A API Geocoding oferece resumos gerados por IA para ajudar os usuários a entender um destino. Esses resumos são fornecidos no Destination objeto no campo arrivalSummary.

Esses resumos são trechos de texto curtos e fáceis de ler, com cerca de 120 caracteres ou 24 palavras ou menos, que encapsulam atributos distintos sobre o destino para ajudar os usuários durante o planejamento e a chegada da viagem.

Exemplo:

• "Atrás da Domino's Pizza ⋅ Prédio de apartamentos de média altura com listras brancas e vermelho-tijolo ⋅ A entrada fica atrás de um portão de metal preto"
• "Prédio de apartamentos alto e creme com varandas ⋅ A entrada fica sob uma grande ponte arqueada sobre a garagem e tem uma cabine de segurança"

Os resumos de chegada são gerados por IA. No entanto, esses resumos são experimentais e podem conter informações imprecisas. Os usuários não devem confiar em resumos gerados por IA como fonte de informação.

Solicitar um resumo de chegada

Para retornar um resumo de chegada na resposta, inclua destinations.arrivalSummary no X-Goog-FieldMask cabeçalho da sua solicitação de pesquisa de destinos:

curl -X POST -d '{
  "place": "places/ChIJAWLGeHRZwokRV4Dojw9TEHA"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: destinations.arrivalSummary" \
https://geocode.googleapis.com/v4alpha/geocode/destinations

Importante: o recurso de resumos gerados por IA é experimental. Formule solicitações HTTP usando o canal /v4alpha/. Mais informações sobre canais de fase de lançamento.

O campo arrival_summary contém um objeto ArrivalSummary com os seguintes campos: text, flag_content_url e disclosure_text.

A resposta está no formato:

{
  "destinations": [
    {
      "arrivalSummary": {
        "text": {
          "text": "Tall red-brick apartment building ⋅ Entrance has a glass front and a grey metal overhang",
          "languageCode": "en"
        },
        "flagContentUrl": "https://www.google.com/local/review/rap/report?postId=...",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    }
  ]
}

Mostrar resumos gerados por IA

Ao mostrar resumos gerados por IA no seu app, inclua o texto de divulgação obrigatório e um link para informar problemas com o resumo.

Texto de divulgação

Ao mostrar um resumo gerado por IA do campo text, inclua o texto de divulgação localizado fornecido no campo disclosure_text do objeto ArrivalSummary na resposta imediatamente abaixo do resumo. Nunca modifique ou aumente o texto de divulgação fornecido pela API.

Informar problemas

Cada resumo contém um flag_content_url que fornece um link para os usuários informarem problemas com o conteúdo do resumo. Ao mostrar um resumo gerado por IA, disponibilize esse link para que os usuários informem problemas com o resumo.

Para mais informações, consulte Políticas da API Geocoding.

Cobertura de destinos

Os resumos gerados por IA estão disponíveis apenas para destinos residenciais nas seguintes regiões metropolitanas:

Estados Unidos

• Atlanta
• Boston
• Chicago
• Dallas-Fort Worth
• Houston
• Las Vegas
• Los Angeles
• Miami
• Nova York
• Filadélfia
• San Diego
• São Francisco
• Seattle
• Washington, D.C.

Índia

• Bangalore (Bengaluru)
• Chennai
• Deli (Nova Deli)
• Hyderabad
• Calcutá
• Mumbai

Feedback

Esse é um recurso experimental da API Geocoding. Agradecemos o feedback em [e-mail].