Text Search (Baru) menampilkan informasi tentang satu set tempat berdasarkan string — misalnya "pizza di Bandung" atau "toko sepatu di dekat Solo" atau "123 Main Street". Tujuan layanan merespons dengan daftar tempat yang cocok dengan string teks dan lokasi mana pun bias yang telah ditetapkan.
Layanan ini sangat berguna untuk membuat kueri alamat ambigu dalam sistem otomatis, dan komponen non-alamat pada string mungkin cocok bisnis serta alamat. Contoh kueri alamat ambigu adalah alamat atau permintaan yang tidak diformat dengan baik yang menyertakan komponen non-alamat seperti sebagai nama bisnis. Permintaan seperti dua contoh pertama dalam tabel berikut mungkin menampilkan nol hasil kecuali lokasi — seperti wilayah, lokasi pembatasan, atau bias lokasi ditetapkan.
"10 High Street, Inggris" atau "123 Main Street, US" | Beberapa "High Street" di Inggris Raya; beberapa "Main Street" di AS. Kueri tidak menampilkan hasil yang diinginkan kecuali pembatasan lokasi atur. |
"Restoran Restoran New York" | Beberapa "ChainRestaurant" lokasi di New York; tidak ada alamat atau bahkan nama jalan. |
"10 High Street, Escher, Inggris Raya" atau "123 Main Street, Pleasanton US" | Hanya satu "Jalan Raya" di kota Escher di Inggris; hanya satu "Jalan Utama" di kota Pleasanton, AS. |
"Nama Restoran Unik New York" | Hanya satu tempat usaha dengan nama ini di New York; tidak ada alamat yang berbeda. |
"restoran pizza di New York" | Kueri ini berisi pembatasan lokasinya, dan "restoran pizza" bernilai jenis tempat yang terdefinisi dengan baik. Operator ini memberikan banyak hasil. |
"+1 514-670-8700" | Kueri ini berisi nomor telepon. Operator ini mengembalikan banyak hasil untuk tempat yang terkait dengan nomor telepon tersebut. |
API Explorer memungkinkan Anda membuat permintaan langsung sehingga Anda dapat membiasakan diri dengan API dan Opsi API:
Permintaan Text Search
Permintaan Text Search adalah permintaan POST HTTP dengan bentuk berikut:
https://places.googleapis.com/v1/places:searchText
Teruskan semua parameter di isi permintaan JSON atau di header sebagai bagian dari permintaan POST. Contoh:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
Respons Text Search (Baru)
Text Search (Baru) menampilkan Objek JSON sebagai respons. Dalam respons:
- Array
places
berisi semua tempat yang cocok. - Setiap tempat dalam {i>array<i} diwakili oleh elemen
Place
. ObjekPlace
berisi informasi mendetail tentang satu saat ini. - FieldMask yang diteruskan dalam permintaan menentukan
daftar kolom yang ditampilkan dalam objek
Place
.
Objek JSON lengkap tersedia dalam bentuk:
{ "places": [ { object (Place) } ] }
Parameter wajib
-
FieldMask
Tentukan daftar kolom yang akan ditampilkan dalam respons dengan membuat mask kolom respons. Teruskan mask kolom respons ke metode menggunakan parameter URL
$fields
ataufields
, atau dengan menggunakan header HTTPX-Goog-FieldMask
. Tidak ada daftar default untuk kolom yang ditampilkan dalam respons. Jika Anda menghilangkan mask kolom, metode akan menampilkan error.Penyamaran kolom adalah praktik desain yang baik untuk memastikan bahwa Anda tidak meminta data yang tidak perlu, yang membantu menghindari waktu pemrosesan yang tidak perlu dan biaya penagihan.
Tentukan daftar yang dipisahkan koma untuk jenis data tempat yang akan ditampilkan. Misalnya, untuk mengambil nama tampilan dan alamat tempat.
X-Goog-FieldMask: places.displayName,places.formattedAddress
Gunakan
*
untuk mengambil semua kolom.X-Goog-FieldMask: *
Tentukan satu atau beberapa kolom berikut:
Kolom berikut memicu SKU Text Search (Khusus ID):
places.attributions
,places.id
,places.name
*nextPageToken
* Kolomplaces.name
berisi nama resource tempat dalam bentuk:places/PLACE_ID
. Gunakanplaces.displayName
untuk mengakses nama tekstual tempat tersebut.Kolom berikut memicu SKU Text Search (Basic):
places.accessibilityOptions
,places.addressComponents
,places.adrFormatAddress
,places.businessStatus
,places.displayName
,places.formattedAddress
,places.googleMapsUri
,places.iconBackgroundColor
,places.iconMaskBaseUri
,places.location
,places.photos
,places.plusCode
,places.primaryType
,places.primaryTypeDisplayName
,places.shortFormattedAddress
,places.subDestinations
,places.types
,places.utcOffsetMinutes
,places.viewport
Kolom berikut memicu SKU Text Search (Advanced):
places.currentOpeningHours
,places.currentSecondaryOpeningHours
,places.internationalPhoneNumber
,places.nationalPhoneNumber
,places.priceLevel
,places.rating
,places.regularOpeningHours
,places.regularSecondaryOpeningHours
,places.userRatingCount
,places.websiteUri
Kolom berikut memicu SKU Text Search (Preferred):
places.allowsDogs
,places.curbsidePickup
,places.delivery
,places.dineIn
,places.editorialSummary
,places.evChargeOptions
,places.fuelOptions
,places.goodForChildren
,places.goodForGroups
,places.goodForWatchingSports
,places.liveMusic
,places.menuForChildren
,places.parkingOptions
,places.paymentOptions
,places.outdoorSeating
,places.reservable
,places.restroom
,places.reviews
,places.servesBeer
,places.servesBreakfast
,places.servesBrunch
,places.servesCocktails
,places.servesCoffee
,places.servesDessert
,places.servesDinner
,places.servesLunch
,places.servesVegetarianFood
,places.servesWine
,places.takeout
-
textQuery
String teks yang digunakan untuk menelusuri, misalnya: "restaurant", "123 Main Street", atau "tempat terbaik untuk dikunjungi di San Francisco". API mengembalikan kandidat berdasarkan pada {i>string<i} ini dan mengurutkan hasil berdasarkan relevansi yang terlihat.
Parameter opsional
includedType
Membatasi hasil pada tempat yang cocok dengan tipe yang ditentukan oleh Tabel A. Hanya satu jenis yang dapat ditentukan. Contoh:
"includedType":"bar"
"includedType":"pharmacy"
languageCode
Bahasa yang digunakan untuk menampilkan hasil.
- Lihat daftar bahasa yang didukung. Google sering memperbarui bahasa yang didukung, sehingga daftar ini mungkin tidak lengkap.
-
Jika
languageCode
tidak diberikan, API akan ditetapkan secara default keen
. Jika Anda menetapkan kode bahasa yang tidak valid, API menampilkan errorINVALID_ARGUMENT
. - API melakukan yang terbaik untuk menyediakan alamat jalan yang dapat dibaca baik pengguna maupun lokal. Untuk mencapai sasaran tersebut, model menampilkan jalan dalam bahasa lokal, ditransliterasi ke skrip yang dapat dibaca oleh pengguna jika perlu, dengan memperhatikan bahasa pilihan. Lainnya alamat ditampilkan dalam bahasa pilihan. Komponen alamat adalah semua dikembalikan dalam bahasa yang sama, yang dipilih dari sumber komponen.
- Jika nama tidak tersedia dalam bahasa pilihan, API akan menggunakan padanan terdekat.
- Bahasa pilihan memiliki pengaruh kecil pada serangkaian hasil yang API memilih untuk dikembalikan, dan urutan pengembaliannya. Tujuan geocoder menafsirkan singkatan secara berbeda bergantung pada bahasa, seperti singkatan jenis jalan, atau sinonim yang mungkin valid dalam satu bahasa tetapi tidak dalam bahasa lain.
locationBias
Menentukan area yang akan ditelusuri. Lokasi ini berfungsi sebagai bias yang berarti hasil di sekitar lokasi yang ditentukan dapat ditampilkan, termasuk hasil di luar area yang ditentukan.
Anda dapat menentukan
locationRestriction
ataulocationBias
, tetapi tidak keduanya. AnggaplocationRestriction
sebagai menentukan wilayah tempat hasil harus berada dalam cakupan, danlocationBias
sebagai yang menetapkan wilayah di mana hasilnya harus dekat tetapi bisa berada di luar area tersebut.Tentukan wilayah sebagai Area Pandang persegi panjang atau dalam bentuk lingkaran.
Lingkaran ditentukan dengan titik pusat dan jari-jari dalam meter. Radius harus antara 0,0 dan 50000,0, inklusif. Radius default adalah 0.0. Contoh:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
Persegi panjang adalah area pandang garis lintang dan garis bujur, yang direpresentasikan sebagai dua berlawanan dengan titik tinggi dan rendah secara diagonal. Titik rendah menandai barat daya sudut persegi panjang tersebut, dan titik tertinggi melambangkan arah timur laut sudut persegi panjang.
Sebuah area pandang dianggap sebagai wilayah tertutup, yang berarti wilayah itu mencakup perbatasannya. Batas lintang harus berkisar antara -90 hingga 90 derajat inklusif, dan batas bujur harus berkisar antara -180 hingga 180 derajat, termasuk:
- Jika
low
=high
, area pandang terdiri dari titik tunggal tersebut. - Jika
low.longitude
>high.longitude
, rentang bujur dibalik (area pandang melintasi 180 derajat garis bujur). - Jika
low.longitude
= -180 derajat danhigh.longitude
= 180 derajat, area pandang mencakup semua bujur. - Jika
low.longitude
= 180 derajat danhigh.longitude
= -180 derajat, rentang bujur adalah kosong. - Jika
low.latitude
>high.latitude
, rentang garis lintang kosong.
Tinggi dan rendah harus diisi, dan kotak yang ditampilkan tidak boleh kosong. Area pandang kosong akan menyebabkan error.
Misalnya, area pandang ini sepenuhnya mencakup New York City:
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
- Jika
locationRestriction
Menentukan area yang akan ditelusuri. Hasil di luar area yang ditentukan tidak dikembalikan. Tentukan wilayah sebagai Area Pandang persegi panjang. Lihat deskripsi dari
locationBias
untuk mendapatkan informasi tentang cara menentukan Area Pandang.Anda dapat menentukan
locationRestriction
ataulocationBias
, tetapi tidak keduanya. AnggaplocationRestriction
sebagai menentukan wilayah tempat hasil harus berada dalam cakupan, danlocationBias
sebagai yang menetapkan wilayah di mana hasilnya harus dekat tetapi bisa berada di luar area tersebut.-
maxResultCount (tidak digunakan lagi)
Menentukan jumlah hasil (antara 1 dan 20) yang ditampilkan per halaman. Misalnya, menetapkan nilai
maxResultCount
5 akan menampilkan hingga 5 hasil di halaman pertama. Jika ada lebih banyak hasil yang dapat ditampilkan dari kueri, responsnya menyertakannextPageToken
yang Anda dapat diteruskan ke permintaan berikutnya untuk mengakses halaman berikutnya. evOptions
Menentukan parameter untuk mengidentifikasi kendaraan listrik (EV) yang tersedia konektor pengisian daya dan kecepatan pengisian daya.
connectorTypes
Filter menurut jenis konektor pengisian daya Kendaraan Listrik Umum yang tersedia di suatu tempat. J tempat yang tidak mendukung jenis konektor apa pun akan difilter posisi-posisi ini. Jenis konektor pengisian daya Kendaraan Listrik termasuk gabungan (AC dan DC) pengisi daya, pengisi daya Tesla, pengisi daya yang sesuai dengan GB/T (untuk pengisian daya kendaraan listrik dalam waktu singkat di China), dan pengisi daya stopkontak. Untuk informasi lebih lanjut, lihat referensi dokumentasi.
minimumChargingRateKw
Memfilter tempat berdasarkan tingkat pengisian daya EV minimum dalam kilowatt (kW). Apa saja tempat dengan tarif pengisian daya kurang dari tarif pengisian minimum disaring. Misalnya, untuk menemukan pengisi daya Kendaraan Listrik dengan kecepatan pengisian daya yang setidaknya 10 kW, Anda dapat mengatur parameter ini ke "10".
minRating
Membatasi hasil hanya untuk hasil yang nilai pengguna rata-ratanya lebih besar dari atau sama dengan batas ini. Nilai harus antara 0,0 dan 5,0 (inklusif) di kenaikan sebesar 0,5. Misalnya: 0, 0.5, 1.0, ... , 5.0 inklusif. Nilai adalah dibulatkan ke angka 0,5 terdekat. Misalnya, nilai 0,6 menghilangkan semua hasil dengan peringkat kurang dari 1,0.
openNow
Jika
true
, hanya tampilkan tempat yang buka pada saat kueri dikirim. Jikafalse
, tampilkan semua bisnis terlepas dari statusnya yang sudah terbuka. Tempat yang tidak menetapkan jam buka dalam database Google Places ditampilkan jika Anda menetapkan parameter ini kefalse
.pageSize
Menentukan jumlah hasil (antara 1 dan 20) yang ditampilkan per halaman. Misalnya, menetapkan nilai
pageSize
5 akan menampilkan hingga 5 hasil di halaman pertama. Jika ada lebih banyak hasil yang dapat ditampilkan dari kueri, responsnya menyertakannextPageToken
yang Anda dapat diteruskan ke permintaan berikutnya untuk mengakses halaman berikutnya.pageToken
Menentukan
nextPageToken
dari isi respons halaman sebelumnya.-
priceLevels
Batasi penelusuran ke tempat yang ditandai dengan tingkat harga tertentu. Setelan defaultnya adalah memilih semua tingkat harga.
Menentukan array dari satu atau beberapa nilai yang ditentukan oleh
PriceLevel
Contoh:
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
rankPreference
Menentukan bagaimana hasil diberi peringkat dalam respons berdasarkan jenis kueri:
- Untuk kueri kategori seperti "Restoran di New York City",
RELEVANCE
(beri peringkat hasil menurut relevansi penelusuran) adalah default. Anda dapat menetapkanrankPreference
keRELEVANCE
atauDISTANCE
(peringkat hasil menurut jarak). - Untuk kueri non-kategori seperti "Mountain View, CA", sebaiknya
Anda membiarkan
rankPreference
tidak disetel.
- Untuk kueri kategori seperti "Restoran di New York City",
regionCode
Kode wilayah yang digunakan untuk memformat respons, yang ditetapkan sebagai kode CLDR dua karakter. Parameter ini juga dapat memiliki efek bias pada hasil penelusuran. Tidak ada nilai default.
Jika nama negara dari kolom
formattedAddress
di kolom respons cocok denganregionCode
, kode negara dihilangkan dariformattedAddress
. Parameter ini tidak berpengaruh padaadrFormatAddress
, yang selalu menyertakan negara nama jika tersedia, atau padashortFormattedAddress
, yang tidak pernah menyertakannya.Sebagian besar kode CLDR identik dengan kode ISO 3166-1, dengan beberapa pengecualian. Misalnya, ccTLD Inggris Raya adalah "uk" (.co.uk) sedangkan kode ISO 3166-1-nya adalah "gb" (secara teknis untuk entitas "Inggris Raya dan Irlandia Utara"). Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku.
strictTypeFiltering
Digunakan dengan parameter
includedType
. Jika ditetapkan ketrue
, hanya tempat yang cocok dengan jenis yang ditentukan olehincludeType
ditampilkan. Jika salah (false), respons default dapat berisi tempat yang tidak cocok tipe-tipe yang ditentukan.
Contoh Text Search
Menemukan tempat berdasarkan string kueri
Contoh berikut menunjukkan permintaan Text Search untuk "Makanan Vegetarian Pedas di Sydney, Australia":
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
Perhatikan bahwa header X-Goog-FieldMask
menentukan bahwa
respons
berisi kolom data berikut: places.displayName,places.formattedAddress
.
Responsnya kemudian dalam bentuk:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, { "formattedAddress": "29 King St, Sydney NSW 2000, Australia", "displayName": { "text": "Peace Harmony", "languageCode": "en" } }, ... ] }
Tambahkan lebih banyak jenis data ke mask kolom untuk menampilkan informasi tambahan.
Misalnya, tambahkan places.types,places.websiteUri
untuk menyertakan
jenis restoran dan alamat Web di
respons:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.types,places.websiteUri' \ 'https://places.googleapis.com/v1/places:searchText'
Responsnya kini berbentuk:
{ "places": [ { "types": [ "vegetarian_restaurant", "vegan_restaurant", "chinese_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "websiteUri": "http://www.motherchusvegetarian.com.au/", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "types": [ "vegan_restaurant", "thai_restaurant", "vegetarian_restaurant", "indian_restaurant", "italian_restaurant", "american_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "websiteUri": "http://www.veggosizzle.com.au/", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, ... ] }
Filter tempat berdasarkan tingkat harga
Gunakan opsi priceLevel
untuk memfilter hasil ke restoran
didefinisikan sebagai murah atau cukup mahal:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia", "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"] }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
Contoh ini juga menggunakan header X-Goog-FieldMask
untuk menambahkan
places.priceLevel
ke kolom data
respons
jadi ini dalam bentuk:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "115 King St, Newtown NSW 2042, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Green Mushroom", "languageCode": "en" } }, ... ] }
Tambahkan opsi tambahan untuk menyaring penelusuran Anda, seperti includedType
,
minRating
, rankPreference
, openNow
,
dan parameter lainnya
yang dijelaskan di
Parameter opsional.
Menelusuri tempat di suatu area
Gunakan locationRestriction
atau locationBias
,
namun tidak keduanya, untuk membatasi pencarian di suatu area. Bayangkan locationRestriction
seperti menentukan region tempat hasil harus berada, dan locationBias
seperti menentukan region yang hasilnya harus dekat tetapi bisa berada di luar
area tersebut.
Contoh berikut menunjukkan permintaan Text Search untuk "Makanan Vegetarian Pedas" dibiaskan pada jarak 500 meter dari titik di pusat kota San Francisco. Permintaan ini hanya mengembalikan 10 hasil pertama untuk tempat-tempat yang terbuka.
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food", "openNow": true, "pageSize": 10, "locationBias": { "circle": { "center": {"latitude": 37.7937, "longitude": -122.3965}, "radius": 500.0 } }, }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
Mencari pengisi daya Kendaraan Listrik dengan kecepatan pengisian daya minimum
Gunakan minimumChargingRateKw
dan connectorTypes
untuk
mencari tempat dengan pengisi daya yang tersedia yang kompatibel dengan EV Anda.
Contoh berikut menunjukkan permintaan untuk pengisian daya EV Tesla dan J1772 tipe 1 konektor dengan kecepatan pengisian daya minimum 10 kW di Mountain View, CA. Hanya empat hasil yang ditampilkan.
curl -X POST -d '{ "textQuery": "EV Charging Station Mountain View", "pageSize": 4, "evOptions": { "minimumChargingRateKw": 10, "connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"] } }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \ 'https://places.googleapis.com/v1/places:searchText'
Permintaan tersebut akan menampilkan respons berikut:
{ "places": [ { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 16, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 100, "count": 8, "availableCount": 5, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 2, "availableCount": 2, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 6, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 6, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 4, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 2, "availableCount": 0, "outOfServiceCount": 2, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 5, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_J1772", "maxChargeRateKw": 3.5999999046325684, "count": 1, "availableCount": 0, "outOfServiceCount": 1, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "Electric Vehicle Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 10, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_OTHER", "maxChargeRateKw": 210, "count": 10 } ] } } ] }
Menentukan jumlah hasil yang akan ditampilkan per halaman
Gunakan parameter pageSize
untuk menentukan jumlah hasil yang akan
yang ditampilkan per halaman. Parameter nextPageToken
dalam isi respons
menyediakan token yang dapat digunakan dalam panggilan berikutnya untuk mengakses halaman
hasil pengujian tersebut.
Contoh berikut menampilkan permintaan "pizza di New York" dibatasi hingga 5 hasil per halaman:
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5 }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJifIePKtZwokRVZ-UdRGkZzs" }, { "id": "ChIJPxPd_P1YwokRfzLhSiACEoU" }, { "id": "ChIJrXXKn5NZwokR78g0ipCnY60" }, { "id": "ChIJ6ySICVZYwokR9rIK8HjXhzE" }, { "id": "ChIJ6xvs94VZwokRnT1D2lX2OTw" } ], "nextPageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }
Untuk mengakses halaman hasil berikutnya, gunakan pageToken
untuk meneruskan
nextPageToken
dalam isi permintaan:
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5, "pageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJL-LN1N1ZwokR8K2jACu6Ydw" }, { "id": "ChIJjaD94kFZwokR-20CXqlpy_4" }, { "id": "ChIJ6ffdpJNZwokRmcafdROM5q0" }, { "id": "ChIJ8Q2WSpJZwokRQz-bYYgEskM" }, { "id": "ChIJ8164qwFZwokRhplkmhvq1uE" } ], "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c" }
Cobalah!
API Explorer memungkinkan Anda membuat contoh permintaan sehingga Anda bisa membiasakan diri dengan API dan opsi API.
Pilih ikon API,
, di sisi kanan halaman.
Jika ingin, luaskan Show standar parameter dan setel
fields
parameter ke kolom penyamaran.Jika ingin, edit Isi permintaan.
Pilih tombol Execute. Di kotak dialog pop-up, pilih akun yang yang ingin Anda gunakan untuk membuat permintaan.
Di panel API Explorer, pilih ikon luaskan,
, untuk meluaskan jendela API Explorer.