Resúmenes de áreas potenciados por IA

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

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

  • "Esta vibrante área de San Francisco, que combina North Beach y Chinatown, se encuentra al noroeste del distrito financiero y cuenta con lugares de interés literario, atracciones culturales únicas y una gastronomía diversa. Entre los lugares destacados, se encuentran la icónica librería City Lights, el fascinante Museo del Teleférico y las bulliciosas calles del Barrio Chino.

    La zona ofrece una combinación única de historia y cultura, donde un entorno apto para peatones invita a la exploración a pesar de algunas colinas y multitudes. Sumérgete en la historia literaria en City Lights Bookstore, experimenta la vibrante cultura del barrio chino con sus templos y fábricas de galletas de la fortuna, o viaja en el tiempo en el Cable Car Museum. Te espera una gran variedad de opciones gastronómicas, desde auténtica cocina china hasta deliciosa pizza".

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

  • "Esta área ofrece una variedad de opciones gastronómicas a 9 minutos a pie, como Starbucks, Sushi Jin y Safeway".

Junto con una descripción del área, la respuesta también contiene una lista de IDs de lugar para 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:

  • Resúmenes de vecindarios, que proporcionan descripciones generales de alto nivel de las atracciones cercanas para los lugares con los tipos premise, street_address y todos los tipos de las categorías Alojamiento y Hospedaje
  • Resúmenes de servicios de estaciones de carga de vehículos eléctricos (EVCS), que proporcionan descripciones generales de alto nivel de las atracciones cercanas para los 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

Los resúmenes de vecindarios se pueden generar para lugares con tipos en las categorías Vivienda y Alojamiento. Para devolver 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 (nuevo) y Nearby Search (nuevo): 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 de 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 "Resumido 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 los servicios de carga de VE

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

  • Place Details (nuevo): evChargeAmenitySummary
  • Text Search (nuevo) y Nearby Search (nuevo): 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 los nombres de recursos de lugares a los que se hace referencia en el formato place/PLACE_ID.
  • Un vínculo de 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 "Resumido con Gemini" que se debe incorporar en las atribuciones.

En el siguiente ejemplo, se solicita un resumen de los servicios 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 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.