Resúmenes de lugares potenciados por IA

Los resúmenes de lugares potenciados por IA son descripciones breves de 100 caracteres específicas para un ID de lugar determinado. Los resúmenes de lugares agregan muchos tipos diferentes de datos en una descripción general de alto nivel para ayudar a los usuarios a obtener una instantánea de un lugar.

Por ejemplo, los resúmenes de lugares pueden destacar comidas, servicios o productos populares disponibles para comprar en una ubicación:

  • "Restaurante de Forum Shops que sirve grandes porciones de comida italiana tradicional en un espacio informal".
  • "Salón elegante que ofrece cortes y tintes, además de peinados".
  • "Tienda grande con muchos vendedores que ofrecen una variedad de decoración, muebles y ropa vintage".

Los resúmenes de lugares son compatibles con Place Details (nuevo), Text Search (nuevo) y Nearby Search (nuevo). Los resúmenes de lugares están disponibles para los tipos de lugares que se muestran en Tipos admitidos para las categorías Cultura, Entretenimiento y recreación, Comida y bebida, Compras, Servicios y Deportes.

Solicita un resumen generativo de un lugar

Para devolver un resumen del lugar en la respuesta, incluye el siguiente campo en la máscara de campo de la solicitud:

  • Place Details (nuevo): generativeSummary
  • Text Search (nuevo) y Nearby Search (nuevo): places.generativeSummary

El campo generativeSummary contiene los siguientes campos:

  • generativeSummary: Es el resumen del lugar.
  • overviewFlagContentUri: Es un vínculo en el que los usuarios pueden marcar un problema con el resumen del lugar.
  • disclosureText: Es una cadena de texto localizada con el texto de divulgación "Resumido con Gemini" que se debe incorporar en las atribuciones.

Solicitud de Place Details (nuevo)

La siguiente solicitud a Place Details (nuevo) devuelve un resumen de overview para un restaurante de sushi en 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"

La respuesta tiene el siguiente 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"
    }
  }
}

Solicitud de Text Search (nuevo)

La siguiente solicitud de Text Search (nuevo) devuelve un resumen overview de los restaurantes vegetarianos picantes en Mountain View, California:

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'

La respuesta tiene el siguiente 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"
        }
      }
    },
    /.../
  ]
}

Solicitud de Nearby Search (nuevo)

La siguiente solicitud de Nearby Search (nuevo) devuelve un resumen de overview para restaurantes y cafeterías en Portland, Oregón:

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'

La respuesta tiene el siguiente 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"
        }
      }
    },
    /.../
  ]
}

Atribuciones

Todos los resúmenes potenciados por IA que se muestren en tu app deben incluir la atribución adecuada de conformidad con las políticas y los estándares de Google. Para obtener más información, consulta las Políticas de la API de Places.