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 para um local, incluindo pontos de interesse nas proximidades, para que os usuários possam tomar uma decisão mais 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 hotel para saber mais sobre a área:

  • "Esta á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 únicas e restaurantes diversos. Entre os pontos turísticos mais famosos 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 amigável para pedestres convida à exploração, apesar de algumas colinas e multidões. Mergulhe na história literária na City Lights Bookstore, conheça a cultura vibrante da Chinatown com seus templos e fábricas de biscoitos da sorte ou volte no tempo no Cable Car Museum. Várias opções de refeições, desde a autêntica culinária chinesa até pizzas deliciosas."

Se você estiver pensando em carregar um veículo elétrico, confira um resumo gerado para uma estação de recarga de veículos elétricos e encontre cafés ou restaurantes nas proximidades enquanto espera:

  • "Esta área oferece várias 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 lugar para os lugares referenciados na descrição.

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

  • Resumos de bairros, que fornecem informações gerais sobre as atrações próximas a lugares com os tipos premise, street_address e todos os tipos nas categorias Housing e Lodging.
  • Resumos de comodidades de estações de recarga de veículos elétricos (EVCS, na sigla em inglês), que oferecem uma visão geral de alto nível das atrações próximas para lugares com o tipo electric_vehicle_charging_station.

Os resumos de área com tecnologia de IA têm suporte em Place Details (novo), Text Search (novo) e Nearby Search (novo).

Solicitar um resumo do bairro

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

  • Place Details (New): 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 formulário 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 o texto de divulgação "Resumido com Gemini", que precisa ser incorporado 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"
    }
  }
}

Solicitar um resumo de comodidades do EVCS

Os resumos de comodidades da estação de recarga de veículos elétricos (EVCS, na sigla em inglês) podem ser gerados para lugares com o 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:

  • Place Details (New): 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 formulário place/PLACE_ID.
  • Um link flagContentUri em que os usuários podem sinalizar um problema com o resumo gerado.
  • Uma string de texto localizado com o texto de divulgação "Resumido com Gemini" que precisa ser incorporado nas atribuições.

O exemplo a seguir solicita um resumo de 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 com tecnologia de IA exibidos no app precisam ser acompanhados da atribuição adequada de acordo com as políticas e os padrões do Google. Para mais informações, consulte a API Policies for Places.