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 local. Eles fornecem mais contexto para 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 do bairro de um hotel para saber mais sobre a área ao redor:

  • "Esta área vibrante em São Francisco, que mistura North Beach e Chinatown, fica a noroeste do distrito financeiro e apresenta marcos literários, atrações culturais exclusivas e restaurantes variados. Entre os locais notáveis estão a icônica livraria City Lights, o fascinante Museu do Bonde e as ruas movimentadas de Chinatown.

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

Se você estiver considerando carregar um veículo elétrico, confira um resumo gerado de uma estação de recarga de veículos elétricos para encontrar cafeterias ou restaurantes próximos para visitar enquanto espera:

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

Além de uma descrição da área, a resposta também contém uma lista de IDs dos locais referenciados na descrição.

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

  • Resumos de bairro, que oferecem visões gerais de alto nível das atrações próximas para locais 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), que oferecem visões gerais de alto nível das atrações próximas para locais com o tipo electric_vehicle_charging_station.

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

Os resumos de área são compatíveis com pontos de interesse nos seguintes idiomas e regiões:

Idioma Região
Inglês Estados Unidos

Solicitar um resumo do bairro

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

  • Place Details (novo) : neighborhoodSummary
  • Text Search (novo) e Nearby Search (novo) : places.neighborhoodSummary

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

  • Dois subcampos: overview e description. O subcampo overview inclui pontos de interesse próximos específicos do local, enquanto o subcampo description fornece informações mais gerais sobre a área ao redor. Cada subcampo inclui uma lista de nomes de recursos de locais referenciados no formato place/PLACE_ID.
  • Um flagContentUri link 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 às atribuições.

O exemplo a seguir solicita um resumo do bairro de 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 de EVCS

Os resumos de comodidades de estações de recarga de veículos elétricos (EVCS) podem ser gerados para locais com o tipo electric_vehicle_charging_station. Para incluir o resumo de comodidades de EVCS na resposta, inclua o seguinte na máscara de campo da solicitação:

  • Place Details (novo) : evChargeAmenitySummary
  • Text Search (novo) e Nearby Search (novo) : places.evChargeAmenitySummary

O campo evChargeAmenitySummary de um local 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 locais 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 o texto de divulgação "Resumido com o Gemini" que precisa ser incorporada às 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 seu 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 Políticas da API Places.