Resúmenes de áreas potenciados por IA

Los resúmenes de áreas potenciados por IA se generan para el área que rodea un lugar. Los resúmenes de área proporcionan contexto adicional para una ubicación, incluidos los lugares de interés cercanos, de modo que los usuarios puedan tomar una decisión más informada sobre dónde ir y qué hacer una vez que lleguen.

Por ejemplo, cuando visites una ciudad nueva, podrás ver un resumen generado del vecindario de un hotel para obtener más información sobre el área circundante:

  • “Esta zona vibrante de San Francisco, que combina North Beach y Chinatown, se encuentra al noroeste del distrito financiero y cuenta con lugares de interés literarios, atracciones culturales únicas y una amplia variedad de restaurantes. Entre los lugares destacados, se encuentran la icónica librería City Lights, el fascinante Museo del Cable Car y las bulliciosas calles de Chinatown.

    El área ofrece una combinación única de historia y cultura, en la que un entorno apto para peatones invita a la exploración a pesar de algunas colinas y multitudes. Sumérgete en la historia literaria en la librería City Lights, experimenta la vibrante cultura del Barrio Chino con sus templos y fábricas de galletas de la fortuna, o retrocede en el tiempo en el Museo del Cable Car. Te esperan una variedad de opciones gastronómicas, desde auténtica cocina china hasta deliciosa pizza".

Si estás considerando cargar un vehículo eléctrico, puedes ver un resumen generado de una estación de carga de vehículos eléctricos para encontrar cafeterías o restaurantes cercanos que puedas visitar mientras esperas:

  • “Esta zona ofrece una variedad de opciones gastronómicas a 9 minutos a pie, como Starbucks, Sushi Jin y Safeway”.

Además de una descripción del área, la respuesta también contiene una lista de los IDs de los lugares a los que se hace referencia en la descripción.

La API de Places (nueva) proporciona dos tipos de resúmenes de áreas potenciados por IA:

  • Resumen de vecindarios, que proporcionan resúmenes generales de las atracciones cercanas para lugares con los tipos premise, street_address y todos los tipos de las categorías Alojamiento y Alojamiento.
  • Resumen de las comodidades de las estaciones de carga de vehículos eléctricos (EVCS), que proporcionan descripciones generales de alto nivel de las atracciones cercanas para lugares con el tipo electric_vehicle_charging_station.

Los resúmenes de áreas potenciados por IA son compatibles con Place Details (nuevo), Text Search (nuevo) y Nearby Search (nuevo).

Solicita un resumen del vecindario

Se pueden generar resúmenes de vecindarios para lugares con tipos de las categorías Vivienda y Alojamiento. Para mostrar un resumen del vecindario en la respuesta, incluye lo siguiente en la máscara de campo de tu solicitud:

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

El campo neighborhoodSummary de un lugar en la respuesta contiene lo siguiente:

  • Dos subcampos: overview y description. El subcampo overview incluye lugares de interés cercanos específicos del lugar, mientras que el subcampo description proporciona información más general sobre el área circundante. Cada subcampo incluye una lista de nombres de recursos de lugares a los que se hace referencia en el formato place/PLACE_ID.
  • Un vínculo flagContentUri en el que los usuarios pueden marcar un problema con el resumen generado.
  • Es una cadena de texto localizada con el texto de divulgación "Resumen con Gemini" que se debe incorporar en las atribuciones.

En el siguiente ejemplo, se solicita un resumen del vecindario de un hotel en la ciudad de Nueva York:

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

La respuesta tiene el siguiente formato:

{
  "id": "ChIJT0DdRo1ZwokRkufwSD-TdGM",
  "displayName": {
    "text": "Courtyard New York Manhattan/SoHo",
    "languageCode": "en"
  }
  "neighborhoodSummary": {
    "overview": {
      "content": {
        "text": "This area resides within SoHo, a trendy Lower Manhattan neighborhood celebrated for its upscale boutiques, designer shops, and thriving art scene. The area is home to the Color Factory and Dominique Ansel Bakery, known for its popular Cronuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "description": {
      "content": {
        "text": "SoHo's walkability and convenient public transportation options make exploration easy. A diverse array of restaurants and cafes cater to varied tastes. SoHo's central location, surrounded by vibrant neighborhoods, contributes to its fast-paced and energetic atmosphere, with a focus on fashion and design.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=&d=17924085&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Solicita un resumen de las comodidades de los EVCS

Se pueden generar resúmenes de las comodidades de las estaciones de carga de vehículos eléctricos (EVCS) para lugares con el tipo electric_vehicle_charging_station. Para incluir el resumen de las comodidades de la estación de carga de VE en la respuesta, incluye lo siguiente en la máscara de campo de tu solicitud:

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

El campo evChargeAmenitySummary de un lugar en la respuesta contiene lo siguiente:

  • Cuatro subcampos: overview, coffee, restaurant y store. Cada subcampo incluye una breve descripción de los puntos de interés cercanos y una lista de nombres de recursos de lugares a los que se hace referencia en el formato place/PLACE_ID.
  • Un vínculo flagContentUri en el que los usuarios pueden marcar un problema con el resumen generado
  • Es una cadena de texto localizada con el texto de divulgación "Resumen con Gemini" que se debe incorporar en las atribuciones.

En el siguiente ejemplo, se solicita un resumen de las comodidades de una estación de carga de VE en Mountain View:

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

La respuesta tiene el siguiente formato:

{
  "id": "ChIJf8j-4z23j4AR_MQ2-bgMmrY",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "evChargeAmenitySummary": {
    "overview": {
      "content": {
        "text": "Within a short walk, there are several coffee and restaurant options, including Clocktower Coffee Roasting Company, Khao Kang Thai Kitchen, and Roger's Deli & Donuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q",
        /.../
      ]
    },
    "coffee": {
      "content": {
        "text": "Clocktower Coffee Roasting Company has Wi-Fi and a variety of coffee and pastries in a laid-back atmosphere.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q"
      ]
    },
    "restaurant": {
      "content": {
        "text": "Roger's Deli & Donuts is a bustling deli with sandwiches and breakfast items.\nJoy Sushi serves classic Japanese dishes, including vegetarian and healthy options.\nSubway is a chain sandwich shop offering its usual subs, wraps, and salads.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJQ4F3PBa3j4ARf7_QjN1Cklo",
        /.../
      ]
    },
    "store": {
      "content": {
        "text": "Rotten Robbie is a chain gas station with a convenience store and a restroom.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJA6deFBa3j4AREY0EyTEGhN8",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ABCDEFG=1234567&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Atribuciones

Todos los resúmenes potenciados por IA que se muestran en tu app deben incluir la atribución adecuada de acuerdo 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.