Resumos de lugares com tecnologia de IA

Os resumos de lugares com tecnologia de IA são visões gerais breves de até 100 caracteres específicas para 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 visão geral 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 porções grandes 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 oferecendo 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 nas categorias Cultura, Entretenimento e recreação, Comida e bebida, Compras, Serviços e Esportes.

Pedir um resumo gerado 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 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 Text Search (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.