Ringkasan area yang didukung AI

Ringkasan area yang didukung AI dibuat untuk area di sekitar suatu tempat. Ringkasan area memberikan konteks tambahan untuk suatu lokasi, termasuk tempat menarik di sekitar, sehingga pengguna dapat membuat keputusan yang lebih tepat tentang tempat tujuan dan aktivitas yang akan dilakukan setelah tiba di sana.

Misalnya, saat mengunjungi kota baru, Anda dapat melihat ringkasan lingkungan yang dibuat untuk hotel guna mempelajari lebih lanjut area di sekitarnya:

  • "Kawasan yang ramai di San Francisco ini, yang memadukan North Beach dan Chinatown, terletak di barat laut Financial District dan menampilkan landmark sastra, objek wisata budaya yang unik, dan beragam tempat makan. Tempat-tempat terkenal meliputi City Lights Bookstore yang ikonis, Cable Car Museum yang menarik, dan jalanan Chinatown yang ramai.

    Area ini menawarkan perpaduan unik antara sejarah dan budaya, di mana lingkungan yang ramah pejalan kaki mengundang eksplorasi meskipun ada beberapa bukit dan keramaian. Selami sejarah sastra di City Lights Bookstore, rasakan budaya Chinatown yang semarak dengan kuil dan pabrik kue keberuntungannya, atau kembali ke masa lalu di Cable Car Museum. Tersedia beragam pilihan tempat makan, mulai dari masakan China autentik hingga pizza lezat."

Jika Anda mempertimbangkan untuk mengisi daya kendaraan listrik, Anda dapat melihat ringkasan yang dibuat untuk stasiun pengisian daya kendaraan listrik guna menemukan kedai kopi atau restoran terdekat untuk dikunjungi saat Anda menunggu:

  • "Area ini menawarkan berbagai pilihan tempat makan dalam jarak 9 menit berjalan kaki, termasuk Starbucks, Sushi Jin, dan Safeway."

Selain deskripsi area, respons juga berisi daftar ID tempat untuk tempat yang dirujuk dalam deskripsi.

Places API (Baru) menyediakan dua jenis ringkasan area yang didukung AI:

  • Ringkasan lingkungan, yang memberikan ringkasan tingkat tinggi tentang daya tarik di sekitar untuk tempat dengan jenis premise, street_address, dan semua jenis dalam kategori Perumahan dan Penginapan.
  • Ringkasan fasilitas stasiun pengisian kendaraan listrik umum (SPKLU), yang memberikan ringkasan umum tentang tempat menarik di sekitar untuk tempat dengan jenis electric_vehicle_charging_station.

Ringkasan area yang didukung teknologi AI tersedia di Place Details (Baru), Text Search (Baru), dan Nearby Search (Baru).

Meminta ringkasan lingkungan

Ringkasan lingkungan dapat dibuat untuk tempat dengan jenis dalam kategori Perumahan dan Penginapan. Untuk menampilkan ringkasan lingkungan dalam respons, sertakan berikut dalam mask kolom permintaan Anda:

  • Detail Tempat (Baru): neighborhoodSummary
  • Text Search (Baru) dan Nearby Search (Baru): places.neighborhoodSummary

Kolom neighborhoodSummary untuk suatu tempat dalam respons berisi berikut:

  • Dua subkolom: overview dan description. Sub-bidang overview mencakup tempat menarik terdekat yang spesifik untuk tempat tersebut, sedangkan sub-bidang description memberikan informasi yang lebih umum tentang area di sekitarnya. Setiap subkolom menyertakan daftar nama resource tempat yang dirujuk dalam bentuk place/PLACE_ID.
  • Link flagContentUri tempat pengguna dapat melaporkan masalah terkait ringkasan yang dihasilkan.
  • String teks yang dilokalkan dengan teks pengungkapan "Diringkas dengan Gemini" yang harus disertakan dalam atribusi.

Contoh berikut meminta ringkasan lingkungan untuk hotel di New York City:

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'

Responsnya dalam bentuk:

{
  "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"
    }
  }
}

Meminta ringkasan fasilitas EVCS

Ringkasan fasilitas stasiun pengisian kendaraan listrik (SPKLU) dapat dibuat untuk tempat dengan jenis electric_vehicle_charging_station. Untuk menyertakan ringkasan fasilitas SPKLU dalam respons, sertakan hal berikut dalam mask kolom permintaan Anda:

  • Detail Tempat (Baru): evChargeAmenitySummary
  • Text Search (Baru) dan Nearby Search (Baru): places.evChargeAmenitySummary

Kolom evChargeAmenitySummary untuk suatu tempat dalam respons berisi hal berikut:

  • Empat sub-kolom: overview, coffee, restaurant, dan store. Setiap sub-bidang mencakup deskripsi singkat tentang lokasi menarik di sekitar dan daftar nama resource tempat yang dirujuk dalam bentuk place/PLACE_ID.
  • Link flagContentUri tempat pengguna dapat melaporkan masalah terkait ringkasan yang dihasilkan.
  • String teks yang dilokalkan dengan teks pengungkapan "Diringkas dengan Gemini" yang harus disertakan dalam atribusi.

Contoh berikut meminta ringkasan fasilitas stasiun pengisian kendaraan listrik untuk stasiun pengisian di 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'

Responsnya dalam bentuk:

{
  "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"
    }
  }
}

Atribusi

Semua ringkasan yang didukung AI yang ditampilkan di aplikasi Anda harus disertai atribusi yang sesuai sesuai dengan kebijakan dan standar Google. Untuk informasi selengkapnya, lihat Kebijakan untuk Places API.