Resumos de lugares com tecnologia de IA

Os resumos de lugares gerados com IA são visões gerais breves de 100 caracteres específicas de um determinado ID de lugar. 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 ideia de um lugar.

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

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

Os resumos de lugares são compatíveis com Place Details (novo), Text Search (novo) e Nearby Search (novo). Os resumos de lugares estão disponíveis para os tipos mostrados em Tipos compatíveis para as categorias Cultura, Entretenimento e recreação, Comida e bebida, Compras, Serviços e Esportes.

Os resumos de lugares estão disponíveis para pontos de interesse nos seguintes idiomas e regiões:

Idioma Região
Inglês

Índia

Estados Unidos

Solicitar 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:

  • Detalhes do lugar (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 a declaração "Resumido com o Gemini" que precisa ser incorporada às 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 do Text Search (novo)

A solicitação de Text Search (novo) a seguir retorna um resumo de overview para restaurantes vegetarianos com comida apimentada 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 do Nearby Search (novo) a seguir retorna um resumo em overview para 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 ser acompanhados da 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.