Resumos de lugares com tecnologia de IA

Os resumos de lugares com tecnologia de IA são breves, com 100 caracteres, e específicos para um determinado ID de lugar. Eles agregam muitos tipos diferentes de dados em uma visão geral de alto nível para ajudar os usuários a ter uma ideia do lugar.

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

  • "Restaurante Forum Shops que serve grandes porções de comida italiana tradicional em um espaço casual."
  • "Salão elegante que oferece cortes de cabelo e coloração, além de escovas."
  • "Grande loja com muitos vendedores que oferecem uma variedade de decoração vintage, móveis e roupas."

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

Os resumos de lugares são compatíveis com pontos de interesse nos seguintes idiomas e regiões:

Idioma Região
Inglês

Índia

Estados Unidos

Solicitar um resumo de lugar gerativo

Para retornar um resumo de 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 incorporada às atribuições.

Solicitação do Place Details (novo)

A solicitação do Place Details (novo) a seguir retorna um resumo de overview para um restaurante japonês 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 do Text Search (novo) a seguir retorna um resumo de overview para restaurantes vegetarianos picantes 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 de 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 com tecnologia de 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.