Resumos de lugares com tecnologia de IA

Os resumos de locais gerados por IA são breves descrições de 100 caracteres específicas para um determinado ID de local. Os resumos de lugares agregam muitos tipos diferentes de dados em uma visão geral de alto nível para ajudar os usuários a ter uma visão geral de um lugar.

Por exemplo, os resumos de locais podem destacar alimentos, serviços ou produtos populares disponíveis para compra em um determinado local:

  • "Restaurante Forum Shops que serve porções generosas de pratos tradicionais italianos em um ambiente descontraído."
  • "Salão elegante que oferece cortes de cabelo e coloração, além de escovas."
  • "Loja grande com muitos vendedores oferecendo uma variedade de decoração vintage, móveis e roupas."

Os resumos de locais são suportados por Detalhes do local (Novo), Pesquisa de texto (Novo) e Pesquisa próxima (Novo). Resumos de locais estão disponíveis para os tipos de locais mostrados em Tipos suportados para as categorias Cultura, Entretenimento e Recreação, Comida e Bebida, Compras, Serviços, e Esportes.

Resumos de locais são suportados para pontos de interesse nos seguintes idiomas e regiões:

Idioma Região
Inglês

Índia

Estados Unidos

Pedir um resumo generativo de um lugar

Para retornar um resumo do lugar na resposta, inclua o seguinte campo na máscara de campo da solicitação:

  • Place Details (novo): generativeSummary
  • Text Search (novo) e Nearby Search (novo): places.generativeSummary

O campo generativeSummary contém os seguintes campos:

  • generativeSummary: o resumo do lugar.
  • overviewFlagContentUri: Um link em que os usuários podem sinalizar um problema com o resumo do lugar.
  • disclosureText: uma string de texto localizada com o texto de divulgação "Resumido com o Gemini", que precisa ser incorporado nas atribuições.

Solicitação do Place Details (novo)

A solicitação de Place Details (novo) a seguir retorna um resumo overview de um restaurante de sushi em Chicago, IL:

curl -X GET https://places.googleapis.com/v1/places/ChIJ1eOF7HLTD4gRry3xPjk8DkU \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,generativeSummary"

A resposta está no formato:

{
  "displayName": {
    "text": "Sushi Nova - Lincoln Park",
    "languageCode": "en"
  },
  "generativeSummary": {
    "overview": {
      "text": "Casual eatery with all-you-can-eat sushi and other Japanese fare, plus beer and sake.",
      "languageCode": "en-US"
    },
    "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDg4MGZkMzcyZWM4NWUzZDU6MHg0NTBlM2MzOTNlZjEyZGFmMAI&d=17924085&t=12",
    "disclaimerText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Solicitação da Pesquisa de texto (novo)

A solicitação de Pesquisa de texto (nova) a seguir retorna um resumo overview de restaurantes vegetarianos apimentados em Mountain View, CA:

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias": {
    "rectangle": {
      "low": {
        "latitude": 37.415,
        "longitude": -122.091
      },
      "high": {
        "latitude": 37.429,
        "longitude": -122.065
      }
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchText'

A resposta está no formato:

{
  "places": [
    {
      "id": "ChIJ8wN5kzm3j4AR_dRdUHoqrPI",
      "displayName": {
        "text": "Plant-Based Vegan Vietnamese",
        "languageCode": "en"
      }
    },
    {
      "id": "ChIJw4RuczO3j4ARC7RByZ5K9nI",
      "displayName": {
        "text": "sweetgreen",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering healthy, made-to-order salads, plates, and grain bowls with vegan options.",
          "languageCode": "en-US"
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzMzNzM2ZTg0YzM6MHg3MmY2NGE5ZWM5NDFiNDBiMAI&d=17924085&t=12",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

Solicitação do Nearby Search (novo)

A solicitação de pesquisa por proximidade (nova) a seguir retorna um resumo overview de restaurantes e cafés em Portland, OR:

curl -X POST -d '{
  "maxResultCount": 5,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 45.553360,
        "longitude": -122.674934
        },
      "radius": 1000
    }
  },
  "includedTypes": ["restaurant", "cafe"],
  "excludedTypes": [],
  "rankPreference":"POPULARITY"
  }' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchNearby'

A resposta está no formato:

{
  "places": [
    {
      "id": "ChIJOa08KlqnlVQR_ZZx1jEcTYY",
      "generativeSummary": {
        "overview": {
          "text": "BBQ and Thai street fare, plus imaginative tropical cocktails, served in a vibrant space.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJU4OzoWynlVQRxlQMpGenSvA",
      "generativeSummary": {
        "overview": {
          "text": "Beer hall with a big selection of German brews, plus a central courtyard with food trucks.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

Atribuições

Todos os resumos gerados por IA exibidos no seu app precisam ter a atribuição adequada, de acordo com as políticas e os padrões do Google. Para mais informações, consulte Políticas da API Places.