Resumos de área com tecnologia de IA

Os resumos de área com tecnologia de IA são gerados para a área ao redor de um lugar. Os resumos de área fornecem mais contexto sobre um local, incluindo pontos de interesse próximos, para que os usuários possam tomar uma decisão mais bem informada sobre onde ir e o que fazer quando chegarem lá.

Por exemplo, ao visitar uma nova cidade, você pode conferir um resumo gerado de um bairro para saber mais sobre a área ao redor de um hotel:

  • "Essa área vibrante de São Francisco, que mistura North Beach e Chinatown, fica a noroeste do Financial District e tem marcos literários, atrações culturais exclusivas e restaurantes variados. Entre os pontos de destaque estão a icônica livraria City Lights, o fascinante Cable Car Museum e as ruas movimentadas de Chinatown.

    A área oferece uma mistura única de história e cultura, onde um ambiente agradável para pedestres convida à exploração, apesar de algumas colinas e multidões. Mergulhe na história literária na livraria City Lights, conheça a cultura vibrante de Chinatown com seus templos e fábricas de biscoitos da sorte ou volte no tempo no Cable Car Museum. Uma variedade de opções de refeições aguarda você, desde a autêntica culinária chinesa até uma deliciosa pizza."

Se você estiver pensando em carregar um veículo elétrico, confira um resumo gerado de um eletroposto para encontrar cafeterias ou restaurantes nas proximidades para visitar enquanto espera:

  • "Esta área oferece uma variedade de opções gastronômicas a 9 minutos a pé, incluindo Starbucks, Sushi Jin e Safeway."

Além de uma descrição da área, a resposta também contém uma lista de IDs de lugares para os locais mencionados na descrição.

A API Places (nova) oferece dois tipos de resumos de área com tecnologia de IA:

  • Resumos de bairros, que oferecem visões gerais de alto nível das atrações próximas para lugares com tipos premise, street_address e todos os tipos nas categorias Moradia e Hospedagem.
  • Resumos de comodidades de estações de recarga de veículos elétricos (EVCS), que oferecem visões gerais de alto nível das atrações próximas para lugares do tipo electric_vehicle_charging_station.

Os resumos de área com tecnologia de IA estão disponíveis em Place Details (novo), Text Search (novo) e Nearby Search (novo).

Pedir um resumo do bairro

Os resumos de bairros podem ser gerados para lugares com tipos nas categorias Habitação e Hospedagem. Para retornar um resumo do bairro na resposta, inclua o seguinte na máscara de campo da sua solicitação:

  • Detalhes do lugar (novo): neighborhoodSummary
  • Text Search (novo) e Nearby Search (novo): places.neighborhoodSummary

O campo neighborhoodSummary de um lugar na resposta contém o seguinte:

  • Dois subcampos: overview e description. O subcampo overview inclui pontos de interesse próximos específicos do lugar, enquanto o subcampo description fornece informações mais gerais sobre a área ao redor. Cada subcampo inclui uma lista de nomes de recursos de lugar referenciados no formato place/PLACE_ID.
  • Um link do flagContentUri em que os usuários podem sinalizar um problema com o resumo gerado.
  • Uma string de texto localizada com o texto de divulgação "Resumido com o Gemini" que precisa ser incorporada nas atribuições.

O exemplo a seguir solicita um resumo do bairro para um hotel na cidade de Nova 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'

A resposta está no 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"
    }
  }
}

Pedir um resumo das comodidades de um EVCS

Os resumos de comodidades de eletropostos podem ser gerados para lugares do tipo electric_vehicle_charging_station. Para incluir o resumo de comodidades do EVCS na resposta, inclua o seguinte na máscara de campo da sua solicitação:

  • Detalhes do lugar (novo): evChargeAmenitySummary
  • Text Search (novo) e Nearby Search (novo): places.evChargeAmenitySummary

O campo evChargeAmenitySummary de um lugar na resposta contém o seguinte:

  • Quatro subcampos: overview, coffee, restaurant e store. Cada subcampo inclui uma breve descrição dos pontos de interesse próximos e uma lista de nomes de recursos de lugar referenciados no formato place/PLACE_ID.
  • Um link flagContentUri em que os usuários podem sinalizar um problema com o resumo gerado.
  • Uma string de texto localizada com a declaração "Resumido com o Gemini" que precisa ser incorporada nas atribuições.

O exemplo a seguir solicita um resumo das comodidades de um eletroposto em 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'

A resposta está no 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"
    }
  }
}

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.