Kemampuan model Gemini untuk Places API

Kemampuan model Gemini untuk Places API (Baru) menghadirkan dukungan untuk LLM ke Places API sehingga Anda dapat menampilkan data yang terkait dengan tempat (jam buka, ulasan, foto) beserta data yang disediakan oleh LLM. Data generatif ini berisi data gabungan dan ringkasan dari LLM untuk meningkatkan kualitas data yang sudah dikaitkan dengan suatu tempat.

Misalnya, Penelusuran Teks (Baru) standar untuk "SPKLU" akan menampilkan daftar tempat yang menawarkan SPKLU. Jenis respons ini tidak masalah jika Anda hanya menelusuri pengisi daya Kendaraan Listrik Umum terdekat atau yang terdekat dan kompatibel dengan kendaraan Anda.

Namun, Anda juga dapat memahami area di sekitar stasiun pengisian daya dengan lebih baik, terutama jika Anda akan berada di sana selama satu jam atau lebih selagi kendaraan Anda diisi dayanya. Saat menggunakan kemampuan model Gemini untuk penelusuran yang sama, respons dapat berisi deskripsi generatif dan dinamis dari setiap tempat dalam respons, termasuk informasi tentang area di sekitar stasiun pengisian daya:

  • "Dalam jarak 2-4 menit berjalan kaki, terdapat beberapa opsi tempat makan dan belanja, termasuk Chef Chu's, Gen Korean BBQ House, Amber India, Pacific Catch, dan beberapa toko bahan makanan seperti Walmart, Whole Foods Market, dan Trader Joe's."

  • "Dalam jarak 1-5 menit berjalan kaki, terdapat beberapa pilihan tempat makan dan belanja, termasuk Khao Kang Thai Kitchen, Roger's Deli & Donuts, dan La Costeña. Untuk sushi, Joy Sushi adalah pilihan yang tepat. Untuk bahan makanan, Dollar Tree menawarkan berbagai produk dengan harga diskon."

Konten generatif dari LLM ini meningkatkan respons dan memberikan informasi tambahan untuk membantu pengguna membuat keputusan yang tepat.

Fitur baru yang didukung AI ditambahkan ke Places API (Baru)

Kemampuan ini menambahkan data berikut ke respons Places API (Baru):

Ringkasan tempat generatif

Ringkasan tempat generatif bersifat khusus untuk ID tempat. Ringkasan tempat menggabungkan berbagai jenis data ke dalam satu ringkasan untuk tempat tersebut.

Places API (Baru) menyediakan dua jenis ringkasan tempat generatif:

  • Ringkasan ringkasan: Ringkasan singkat tentang suatu tempat, rata-rata sekitar 100 karakter, yang dapat membantu pengguna mendapatkan ringkasan tentang suatu tempat.

  • Ringkasan deskripsi: Ringkasan tempat yang lebih panjang, rata-rata sekitar 400 karakter, yang memberikan ringkasan mendetail yang mencakup aspek utama tempat.

Ringkasan tempat saat ini tersedia untuk jenis tempat yang ditampilkan di Jenis yang didukung untuk kategori Budaya, Hiburan dan Rekreasi, Makanan dan Minuman, Shopping, dan Olahraga.

Ringkasan area generatif

Ringkasan area generatif dibuat oleh LLM untuk area di sekitar tempat. Ringkasan area untuk suatu tempat mungkin berisi semua informasi yang diperlukan pengguna untuk membuat keputusan, tanpa harus membuat permintaan lebih lanjut untuk melihat detail area.

Bersama dengan deskripsi area, respons juga berisi daftar ID tempat untuk tempat yang dirujuk dalam deskripsi, dan daftar tempat yang diurutkan menurut berbagai jenis konten. Misalnya, satu jenis konten berisi daftar tempat yang terkait dengan aktivitas di area tersebut, dan jenis konten lainnya berisi daftar restoran di area tersebut.

Ringkasan area saat ini tersedia untuk jenis tempat yang ditampilkan di Jenis yang didukung untuk kategori Penginapan, serta jenis tempat tertentu electric_vehicle_charging_station, geocode, dan premise.

Pembuatan ringkasan tempat dan area

Ringkasan tempat generatif dan ringkasan area generatif sering kali dibuat secara offline oleh Google. Dengan membuat ringkasan ini secara offline, Anda dapat memanfaatkan konten yang didukung oleh Gemini sekaligus tetap melihat performa yang sama dari Places API (Baru) yang sudah Anda harapkan.

Google sering membuat ulang ringkasan ini untuk memastikan ringkasan tersebut bersifat terbaru berdasarkan informasi terbaru yang tersedia. Artinya, Anda akan menampilkan data terbaru di layanan saat memanggil API.

Hasil penelusuran kontekstual

Text Search (Baru) menampilkan informasi tentang serangkaian tempat berdasarkan suatu string — misalnya "pizza di Bandung" atau "toko sepatu dekat Solo". Respons Text Search (Baru) berisi daftar tempat yang cocok dengan string teks dan bias lokasi yang ditetapkan dalam permintaan.

Saat Anda menambahkan hasil penelusuran kontekstual ke respons, respons kini menyertakan ulasan, foto, dan justifikasi yang membantu pengguna menjawab pertanyaan:

  • Mengapa saya melihat tempat ini di hasil penelusuran?
  • Mengapa saya harus memilih tempat ini?

Misalnya, Anda membuat permintaan ke Place Details (Baru), Text Search (Baru), atau Nearby Search (Baru) hari ini yang menyertakan tempat tertentu dalam respons. Data respons untuk tempat tersebut sama untuk ketiga permintaan karena data yang ditampilkan dikaitkan dengan tempat tersebut.

Namun, untuk Text Search (Baru) yang menggunakan kemampuan baru, respons dapat menyertakan data yang berasal dari string kueri input itu sendiri. Artinya, hasil penelusuran kontekstual bersifat unik untuk string kueri. Misalnya, Anda membuat permintaan Text Search (Baru) dengan string kueri berikut:

"Restoran vegetarian pedas di Mountain View, CA"

Kemudian, Anda membiarkan semua parameter input tetap sama dan hanya mengubah string kueri menjadi:

"Restoran vegan pedas di Mountain View, CA"

Untuk restoran yang muncul di kedua respons, data respons tentang tempat tersebut sama karena data tersebut dikaitkan dengan tempat itu sendiri. Namun, hasil penelusuran kontekstual bersifat unik untuk kueri karena berasal dari string kueri. Kemudian, Anda dapat menampilkan ulasan, foto, dan justifikasi dari hasil penelusuran kontekstual kepada pengguna untuk membantu mereka memutuskan tempat mana dalam respons yang paling sesuai dengan permintaan penelusuran mereka.

Mengaktifkan kemampuan model Gemini untuk Places API (Baru)

Anda harus mengaktifkan Places API (Baru) untuk menggunakan kemampuan model Gemini untuk Places API (Baru). Untuk mengetahui informasi selengkapnya, lihat Menyiapkan project Google Cloud.

Batasan untuk rilis eksperimental

Rilis ini hanya mendukung ringkasan tempat dan area untuk tempat di Amerika Serikat dalam bahasa Inggris saja.

Apa itu Gemini?

Untuk mempelajari model Gemini, lihat FAQ Gemini.

Meminta ringkasan tempat generatif

Ringkasan tempat adalah ringkasan generatif yang dibuat oleh LLM untuk tempat tertentu. Places API (Baru) menambahkan dua jenis ringkasan ke respons:

  • Ringkasan generatif Ringkasan yang mirip dengan ringkasan editorial statis yang terkait dengan suatu tempat. Ringkasan singkat generatif, rata-rata sekitar 100 karakter, memiliki beberapa keunggulan:

    • Banyak tempat tidak memiliki ringkasan editorial, sehingga ringkasan editorial mengisi celah dalam informasi yang tersedia untuk suatu tempat.

    • ID ini dibuat dari LLM sehingga pemilik tempat tidak perlu mengelolanya.

  • Ringkasan generatif Deskripsi berasal dari banyak sumber, termasuk ulasan dari Google Maps. Deskripsi, rata-rata sekitar 400 karakter, menyertakan daftar ulasan yang digunakan untuk membuat deskripsi panjang.

    Untuk membuat ringkasan deskripsi secara manual, seseorang harus menggabungkan data dari banyak lokasi, lalu membuat dan mengelola konten secara manual. Kemampuan model Gemini untuk Places API (Baru) membuat ringkasan ini dari LLM untuk mempertahankan cakupan dan keaktualan konten yang dihasilkan.

Ringkasan tempat didukung oleh Place Details (New), Text Search (New), dan Nearby Search (New). Untuk menyertakan ringkasan tempat dalam respons, sertakan kolom berikut dalam mask kolom permintaan:

  • Place Details: generativeSummary

  • Penelusuran Teks dan Penelusuran Langsung: places.generativeSummary

Kolom generativeSummary berisi kolom berikut:

  • generativeSummary.overview: Ringkasan ringkasan generatif.
  • generativeSummary.description: Ringkasan deskripsi generatif.
  • generativeSummary.references: Array yang berisi hingga lima ulasan yang digunakan untuk menyediakan konten untuk ringkasan deskripsi. Jika tidak ada ringkasan deskripsi, array ini akan kosong.
  • overviewFlagContentUri: Link tempat pengguna dapat melaporkan masalah pada ringkasan ringkasan.
  • descriptionFlagContentUri: Link tempat pengguna dapat melaporkan masalah dengan ringkasan deskripsi.

Contoh permintaan ringkasan deskripsi dan ringkasan

Contoh ini menggunakan mask kolom places.generativeSummary untuk menampilkan seluruh objek generativeSummary, termasuk kolom generativeSummary.overview, generativeSummary.description, dan generativeSummary.references:

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
https://places.googleapis.com/v1/places:searchText

Responsnya dalam bentuk:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        },
        "description": {
          "text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
          Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
          available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
          seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
          "languageCode": "en-US"
        },
        "references": {
          "reviews": [
            {
              "name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
              "relativePublishTimeDescription": "12 months ago",
              "rating": 5,
              "text": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "John Smith",
                "uri": "https://www.google.com/maps/contrib/11685942231/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
              "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670"
            },
            . . .
          ]
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12",
        "descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12"
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
          "languageCode": "en-US"
        },
        . . .
}

Contoh permintaan ringkasan ringkasan

Contoh Penelusuran Teks ini hanya menampilkan ringkasan overview untuk restoran vegetarian pedas di Mountain View, CA:

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary.overview" \
https://places.googleapis.com/v1/places:searchText

Responsnya berisi kolom generativeSummary.overview yang mencakup overview.text dan overview.languageCode:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
          "languageCode": "en-US"
        }
      }
    },
  . . .
}

Meminta ringkasan area generatif

Ringkasan area adalah ringkasan generatif yang dibuat oleh LLM untuk area terdekat dari suatu tempat. Ringkasan area dapat menjadi penting bagi pengguna yang membuat keputusan tentang tempat.

Misalnya, Anda ingin memesan hotel di kota baru dan meskipun dapat menemukan hotel yang memenuhi persyaratan, Anda juga ingin mengetahui lebih lanjut area di sekitar hotel. Daripada melihat peta area sekitar, lalu harus menyelidiki setiap tempat di peta, Anda dapat membuat ringkasan area untuk hotel.

Ringkasan area didukung oleh Place Details (Baru), Text Search (Baru), dan Nearby Search (Baru).

Untuk menyertakan ringkasan area dalam respons, sertakan dalam mask kolom permintaan:

  • areaSummary (Place Details)
  • places.areaSummary (Text Search dan Nearby Search).

Kolom areaSummary untuk tempat dalam respons berisi kolom flagContentUri yang dapat Anda gunakan untuk menandai konten tidak pantas sehingga Google dapat menghapusnya. Array ini juga berisi array hingga empat contentBlocks. Topik untuk setiap blok didasarkan pada jenis tempat:

  • Untuk SPKLU, yang ditentukan sebagai tempat jenis electric_vehicle_charging_station, blok topik mencakup: "overview", "coffee", "restaurant", dan "store".

  • Untuk tempat dengan jenis yang ditentukan oleh kategori Penginapan, dan jenis tempat tertentu geocode dan premise, blok topik mencakup: "overview", "activity", "restaurant", dan "store".

Contoh permintaan untuk ringkasan area Stasiun Pengisian Kendaraan Listrik Umum

Contoh permintaan Place Details ini menampilkan ringkasan area untuk stasiun pengisian daya kendaraan listrik tertentu di Mountain View, yang diidentifikasi dengan ID tempat ChIJC5b6QKiwj4ARgn2EwlnJnWU:

curl -X GET -H 'Content-Type: application/json' \
  -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: id,displayName,areaSummary" \
  https://places.googleapis.com/v1/places/ChIJC5b6QKiwj4ARgn2EwlnJnWU

Responsnya berisi kolom areaSummary, termasuk array contentBlocks:

  • Kolom topic menentukan jenis blok konten. Karena tempat dalam contoh ini adalah stasiun pengisian kendaraan listrik umum, empat blok kontennya adalah "overview", "coffee", "restaurant", dan "store".

  • Kolom content menyertakan ringkasan untuk topik tersebut, termasuk kode bahasa.

  • Array references menentukan nama resource tempat, dalam bentuk places/PLACE_ID, yang digunakan untuk menyediakan konten untuk blok konten.

{
  "id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "areaSummary": {
    "contentBlocks": [
      {
        "topic": "overview",
        "content": {
          "text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
          ]
        }
      },
      {
        "topic": "coffee",
        "content": {
          "text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
          ]
        }
      },
      {
        "topic": "restaurant",
        "content": {
          "text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
            "places/ChIJETHw0F-7j4AR85V_I6OobCI",
            "places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
            "places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
          ]
        }
      },
      {
        "topic": "store",
        "content": {
          "text": "Safeway provides a range of groceries, along with a deli and a bakery.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
          ]
        }
      }
    ],
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12"
  }
}

Contoh permintaan ringkasan area untuk hotel

Contoh permintaan Text Search ini meminta hotel di Mountain View, CA:

curl -X  POST -d '{
  "textQuery": "Hotels",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.areaSummary" \
https://places.googleapis.com/v1/places:searchText

Respons berisi kolom areaSummary, termasuk array contentBlocks. Respons untuk tempat berjenis hotel berisi blok konten untuk topik "overview", "activity", "restaurant", dan "store":

{
  "places": [
    {
      "id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
      "displayName": {
        "text": "Shashi Hotel Mountain View, an Urban Resort",
        "languageCode": "en"
      },
      "areaSummary": {
        "contentBlocks": [
          {
            "topic": "overview",
            "content": {
              "text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJo4za6vi5j4ARMua093RgGGA",
                "places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
              ]
            }
          },
          {
            "topic": "activity",
            "content": {
              "text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
              ]
            }
          },
          {
            "topic": "restaurant",
            "content": {
              "text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
                "places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
                "places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
              ]
            }
          },
          {
            "topic": "store",
            "content": {
              "text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJh64-r0O3j4ARy1P41IH2j3k",
                "places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
              ]
            }
          }
        ],
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12"
      }
    },
    ...
  ]
}

Meminta hasil penelusuran kontekstual

Respons terhadap permintaan Text Search (New) berisi array tempat yang cocok dengan kriteria string penelusuran input. Sekarang Anda dapat meminta data penelusuran kontekstual dalam respons berdasarkan kueri input ke API.

Untuk mendukung ringkasan kontekstual, respons dari Text Search (New) berisi array baru bernama contextualContents pada level yang sama dengan array places dalam respons:

{
  "places": [],
  "contextualContents":[]
}

Setiap elemen dalam array contextualContents, dengan jenis ContextualContent, berada di lokasi array yang sesuai sebagai tempat dalam array places. Artinya, elemen di contextualContents[0] sesuai dengan tempat di places[0].

Setiap elemen array berisi kolom array berikut:

  • contextualContents.reviews: Array yang berisi maksimal tiga ulasan.
  • contextualContents.photos: Array yang berisi maksimal lima foto.

  • contextualContents.justifications: Array justifikasi untuk tempat, termasuk:

    • reviewJustification: Menandai bagian ulasan pengguna yang mungkin menarik bagi pengguna akhir.
    • businessAvailabilityAttributesJustification: Mencakup atribut untuk bisnis yang mungkin menarik bagi pengguna akhir.

Untuk menyertakan hasil penelusuran kontekstual dalam respons, sertakan contextualContents dalam mask kolom permintaan Text Search (New):

curl -X  POST  -d '{
  "textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
  "openNow": true,
  "maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText

Responsnya berisi array contextualContents untuk setiap tempat dalam respons:

{
  "places": [
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      }
    },
    . . .
  ],
  "contextualContents": [
    {
      "reviews": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
          "relativePublishTimeDescription": "a year ago",
          "rating": 5,
          "text": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
            the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
            enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset
            to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
            We enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Jane Doe",
            "uri": "https://www.google.com/maps/contrib/113193/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB",
          "relativePublishTimeDescription": "10 months ago",
          "rating": 5,
          "text": {
            "text": "This is a nice little spot to eat at. I'm a big fan of
            curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "This is a nice little spot to eat at. I'm a big fan of curries,
            and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Bob Jones",
            "uri": "https://www.google.com/maps/contrib/11034435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db"
        },
        . . .
      ],
      "photos": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
          "widthPx": 1920,
          "heightPx": 1080,
          "authorAttributions": [
            {
              "displayName": "A Google User",
              "uri": "//maps.google.com/maps/contrib/113010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db"
        },
        . . .
      ],
      "justifications": [
        {
          "reviewJustification": {
            "highlightedText": {
              "text": "\"Not too spicy or oily.\"",
              "highlightedTextRanges": [
                {
                  "startIndex": 9,
                  "endIndex": 14
                }
              ]
            },
            "review": {
              "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
              "relativePublishTimeDescription": "10 months ago",
              "rating": 5,
              "text": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "Stan Davis",
                "uri": "https://www.google.com/maps/contrib/112959/reviews",
                "photoUri": "https://lh3.googleuser-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z",
              "flagContentUri": "https://www.google.com/local/review/rap/report?postt=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

Panduan penerapan untuk kasus penggunaan otomotif

Untuk keselamatan pengemudi, Google merekomendasikan untuk merender ringkasan AI generatif dalam mode parkir untuk pengalaman otomotif. Jika merender ringkasan dalam mode mengemudi, informasi di layar harus sederhana, jelas, dan ringkas untuk memastikan bahwa perhatian pengemudi kembali ke jalan dengan cepat.

  • Tidak lebih dari 3 baris
  • 120 karakter atau 24 kata atau kurang
  • Ukuran depan minimum 24dp

Khusus dalam konteks otomotif, developer bertanggung jawab untuk merender ringkasan AI generatif dengan cara yang aman dan mematuhi semua hukum dan peraturan setempat.

Atribusi

Saat menampilkan ulasan, foto, dan ringkasan AI generatif di aplikasi, termasuk ringkasan tempat dan area, Anda harus memastikan bahwa Anda juga menampilkan atribusi yang diperlukan.

Menampilkan atribusi untuk ringkasan generatif

Saat menampilkan ringkasan AI generatif di aplikasi, termasuk ringkasan tempat dan area, Anda juga harus menampilkan atribusi yang diperlukan. Bagian ini menjelaskan cara menampilkan atribusi berdasarkan cara Anda menampilkan ringkasan AI generatif di aplikasi.

Dalam semua kasus, atribusi harus menggunakan kapitalisasi kalimat. Atribusi dan logo Google harus sesuai dengan semua standar warna, gaya, dan jenis huruf. Untuk informasi selengkapnya tentang standar ini, lihat Kebijakan untuk Places API (Baru).

Ringkasan AI generatif yang ditampilkan dalam konteks data Google lainnya

Dalam hal ini, atribusi AI generatif dapat ditampilkan sendiri di atas atau di bawah ringkasan, dengan mengandalkan atribusi Google untuk konten di tempat lain.

Untuk atribusi, gunakan teks "Dringkas oleh AI" seperti yang ditampilkan dalam gambar ini:

Untuk atribusi, gunakan teks Diringkas oleh AI.

Ringkasan AI generatif ditampilkan secara terpisah

Jika ringkasan AI generatif muncul secara terpisah dari konten lain dari Google Maps, ringkasan tersebut harus menyertakan atribusi AI generatif dan atribusi ke Google yang dipisahkan oleh interpunk. Untuk atribusi, gunakan teks "Dringkas oleh AI" dan logo Google seperti yang ditampilkan dalam gambar ini:

Untuk ringkasan yang ditampilkan secara terpisah, sertakan atribusi AI generatif dan atribusi Google yang dipisahkan oleh interpunk.

Ringkasan AI generatif yang diulang dalam daftar

Saat mengulangi ringkasan ringkasan tempat AI generatif dalam daftar tempat, dengan semua:

  • Konten daftar diatribusikan ke Google
  • Ringkasan yang ditampilkan dibuat AI
  • Konten tersedia dari Google

Atribusi harus ditampilkan di atas atau di bawah daftar dalam satu baris. Atribusi AI rata kiri dan atribusi Google rata kanan:

Untuk daftar, tampilkan atribusi di atas atau di bawah daftar pada satu baris.

Jika ringkasan deskripsi AI generatif dalam bentuk yang lebih panjang digunakan dalam daftar, setiap ringkasan harus memiliki atribusi AI ("Dringkas oleh AI" dengan ikon/tombol info).

Menampilkan informasi tentang ringkasan AI generatif dalam dialog

Bersama dengan ringkasan AI generatif, Anda harus menyediakan dialog untuk pengguna akhir yang menampilkan informasi tentang ringkasan, dan link untuk melaporkan masalah menggunakan ID unik ringkasan yang terdapat di kolom flagContentUri. Saat menggunakan ringkasan deskripsi AI generatif, Anda harus menyertakan informasi tentang sumber ringkasan, yang disebut referensi.

Aktifkan akses ke dialog ini dengan menyertakan ikon info (sebagai affordance interaktivitas) bersama dengan atribusi AI (seperti yang digambarkan dalam contoh di atas) dan membuat area dan ikon atribusi AI merespons tekan/klik.

Untuk ringkasan tempat generatif, tampilkan:

Tentang Ringkasan tempat AI dibuat dari ulasan Google dan data lainnya.
Melaporkan Masalah Untuk melaporkan masalah ke Google terkait konten ringkasan, gunakan link yang terdapat di kolom flagContentUri.
Referensi Ulasan sumber

Contoh:

Menampilkan informasi tentang ringkasan AI generatif dalam dialog.

Untuk ringkasan area generatif, tampilkan:

Tentang Ringkasan area AI dibuat dari ulasan Google dan data lokal.
Melaporkan Masalah Untuk melaporkan masalah ke Google terkait konten ringkasan, gunakan link yang terdapat di kolom flagContentUri.

Menampilkan atribusi ringkasan area.