Text Search (Baru) menampilkan informasi tentang serangkaian tempat berdasarkan suatu string — misalnya "pizza di Bandung" atau "toko sepatu di dekat Solo" atau "Jl. Rajawali 3". Layanan merespons dengan daftar tempat yang cocok dengan string teks dan bias lokasi yang telah ditetapkan.
Layanan ini sangat berguna untuk membuat kueri alamat ambigu dalam sistem otomatis, dan komponen non-alamat pada string dapat cocok dengan bisnis serta alamat. Contoh kueri alamat ambigu adalah alamat atau permintaan yang diformat dengan buruk yang menyertakan komponen non-alamat, seperti nama bisnis. Permintaan seperti dua contoh pertama dalam tabel berikut mungkin menampilkan hasil nol kecuali jika lokasi — seperti wilayah, pembatasan lokasi, atau bias lokasi — ditetapkan.
"10 High Street, UK" atau "123 Main Street, US" | Beberapa "High Street" di Inggris; beberapa "Main Street" di AS. Kueri tidak menampilkan hasil yang diinginkan kecuali jika pembatasan lokasi ditetapkan. |
"Restoran Restoran New York" | Beberapa lokasi "ChainRestaurant" di New York; tanpa alamat atau bahkan nama jalan. |
"10 High Street, Escher UK" atau "123 Main Street, Pleasanton US" | Hanya satu "High Street" di kota Escher, Inggris Raya; hanya satu "Main Street" di kota Pleasanton CA, AS. |
"Nama Restoran Unik New York" | Hanya satu tempat dengan nama ini di New York; tidak perlu alamat untuk membedakannya. |
"restoran pizza di New York" | Kueri ini berisi pembatasan lokasinya, dan "restoran pizza" adalah jenis tempat yang ditetapkan dengan baik. Operator ini memberikan banyak hasil. |
"+1 514-670-8700" | Kueri ini berisi nomor telepon. Metode ini akan menampilkan beberapa hasil untuk tempat yang terkait dengan nomor telepon tersebut. |
API Explorer memungkinkan Anda membuat permintaan langsung sehingga 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 dalam 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 array direpresentasikan oleh objek
Place
. ObjekPlace
berisi informasi mendetail tentang satu tempat. - 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 Anda tidak meminta data yang tidak perlu. Cara ini akan membantu Anda menghindari waktu pemrosesan dan biaya penagihan yang tidak perlu.
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.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 Surabaya". API akan menampilkan kandidat yang cocok berdasarkan string ini dan mengurutkan hasil berdasarkan relevansi yang terlihat.
Parameter opsional
includedType
Membatasi hasil ke tempat yang cocok dengan jenis 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 tidak selalu lengkap.
-
Jika
languageCode
tidak diberikan, API akan ditetapkan secara default keen
. Jika Anda menetapkan kode bahasa yang tidak valid, API akan menampilkan errorINVALID_ARGUMENT
. - API melakukan yang terbaik untuk menyediakan alamat yang dapat dibaca oleh pengguna dan pengguna lokal. Untuk mencapai tujuan tersebut, metode ini menampilkan alamat dalam bahasa lokal, yang ditransliterasi ke skrip yang dapat dibaca oleh pengguna jika perlu, dengan memperhatikan bahasa pilihan. Semua alamat lainnya akan ditampilkan dalam bahasa pilihan. Semua komponen alamat ditampilkan dalam bahasa yang sama, yang dipilih dari komponen pertama.
- Jika nama tidak tersedia dalam bahasa yang dipilih, API akan menggunakan kecocokan terdekat.
- Bahasa yang dipilih memiliki pengaruh kecil pada serangkaian hasil yang dipilih API untuk ditampilkan, dan urutan ditampilkannya. Geocoder menafsirkan singkatan secara berbeda bergantung pada bahasa, seperti singkatan untuk 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. BayangkanlocationRestriction
sebagai menentukan wilayah tempat hasil harus berada, danlocationBias
yang menentukan wilayah di mana hasilnya harus berada di dekat area tersebut, 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 50.000,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 titik rendah dan tinggi yang berlawanan secara diagonal. Titik rendah menandai sudut barat daya persegi panjang, dan titik tinggi mewakili sudut timur laut persegi panjang.
Area tampilan dianggap sebagai wilayah tertutup, yang berarti area tersebut menyertakan batasnya. Batas lintang harus berkisar antara -90 hingga 90 derajat inklusif, dan batas bujur harus berkisar antara -180 hingga 180 derajat inklusif:
- Jika
low
=high
, area pandang terdiri dari titik tunggal tersebut. - Jika
low.longitude
>high.longitude
, rentang bujur dibalik (area pandang melintasi garis bujur 180 derajat). - Jika
low.longitude
= -180 derajat danhigh.longitude
= 180 derajat, area pandang akan menyertakan semua bujur. - Jika
low.longitude
= 180 derajat danhigh.longitude
= -180 derajat, rentang bujur kosong. - Jika
low.latitude
>high.latitude
, rentang garis lintang kosong.
Nilai rendah dan tinggi 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 akan ditampilkan. Tentukan wilayah sebagai Area Pandang persegi panjang. Lihat deskripsi
locationBias
untuk informasi tentang cara menentukan Area Pandang.Anda dapat menentukan
locationRestriction
ataulocationBias
, tetapi tidak keduanya. BayangkanlocationRestriction
sebagai menentukan wilayah tempat hasil harus berada, danlocationBias
yang menentukan wilayah di mana hasilnya harus berada di dekat area tersebut, 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 akan menyertakannextPageToken
yang dapat Anda teruskan ke dalam permintaan berikutnya untuk mengakses halaman berikutnya. evOptions
Menentukan parameter untuk mengidentifikasi konektor pengisian daya kendaraan listrik (EV) dan kecepatan pengisian daya yang tersedia.
connectorTypes
Filter menurut jenis konektor pengisian daya Kendaraan Listrik Umum yang tersedia di suatu tempat. Tempat yang tidak mendukung jenis konektor apa pun akan difilter. Jenis konektor pengisian daya kendaraan listrik yang didukung mencakup pengisi daya gabungan (AC dan DC), pengisi daya Tesla, pengisi daya yang mematuhi standar GB/T (untuk pengisian daya kendaraan listrik cepat di China), dan pengisi daya stopkontak. Untuk informasi selengkapnya, lihat dokumentasi referensi.
minimumChargingRateKw
Memfilter tempat berdasarkan tingkat pengisian daya EV minimum dalam kilowatt (kW). Semua tempat dengan tarif pengisian daya yang kurang dari tarif pengisian daya minimum akan difilter. Misalnya, untuk menemukan pengisi daya Kendaraan Listrik dengan kecepatan pengisian daya minimal 10 kW, Anda dapat menetapkan parameter ini ke "10".
minRating
Membatasi hasil hanya untuk hasil yang rating pengguna rata-ratanya lebih besar dari atau sama dengan batas ini. Nilai harus antara 0,0 dan 5,0 (inklusif) dengan kelipatan 0,5. Misalnya: 0, 0.5, 1.0, ... , 5.0 inklusif. Nilai dibulatkan ke atas ke 0,5 terdekat. Misalnya, nilai 0,6 menghapus semua hasil dengan rating kurang dari 1,0.
openNow
Jika
true
, hanya tampilkan tempat yang sedang buka pada saat kueri dikirim. Jikafalse
, tampilkan semua bisnis terlepas dari status buka. Tempat yang tidak menetapkan jam buka dalam database Google Places akan 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 akan menyertakannextPageToken
yang dapat Anda teruskan ke dalam 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.
Tentukan array dari satu atau beberapa nilai yang ditentukan oleh
PriceLevel
.Contoh:
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
rankPreference
Menentukan peringkat hasil dalam respons berdasarkan jenis kueri:
- Untuk kueri kategori seperti "Restoran di New York City",
RELEVANCE
(peringkat hasil menurut relevansi penelusuran) adalah default. Anda dapat menetapkanrankPreference
keRELEVANCE
atauDISTANCE
(memberi peringkat hasil menurut jarak). - Untuk kueri non-kategori seperti "Mountain View, CA", sebaiknya
biarkan
rankPreference
tidak disetel.
- Untuk kueri kategori seperti "Restoran di New York City",
regionCode
Kode wilayah yang digunakan untuk memformat respons, ditetapkan sebagai nilai kode CLDR dua karakter. Parameter ini juga dapat memiliki efek bias pada hasil penelusuran. Tidak ada nilai default.
Jika nama negara kolom
formattedAddress
dalam respons cocok denganregionCode
, kode negara akan dihilangkan dariformattedAddress
. Parameter ini tidak berpengaruh padaadrFormatAddress
, yang selalu menyertakan nama negara jika tersedia, atau dishortFormattedAddress
, 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
yang akan ditampilkan. Jika salah (false), respons default dapat berisi tempat yang tidak cocok dengan jenis yang ditentukan.
Contoh Text Search
Menemukan tempat berdasarkan string kueri
Contoh berikut menampilkan 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
menetapkan 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 dalam 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 yang didefinisikan sebagai murah atau lumayan 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
kolom data places.priceLevel
ke
respons
sehingga 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, seperti includedType
, minRating
, rankPreference
, openNow
, dan parameter lainnya yang dijelaskan dalam Parameter opsional.
Menelusuri tempat di suatu area
Gunakan locationRestriction
atau locationBias
, tetapi jangan keduanya, untuk membatasi penelusuran pada suatu area. Bayangkan locationRestriction
sebagai menentukan wilayah tempat hasil harus berada di dalamnya, dan locationBias
sebagai yang menentukan wilayah di mana hasilnya harus dekat, tetapi bisa berada di luar
area tersebut.
Contoh berikut menunjukkan permintaan Text Search untuk "Makanan Vegetarian Pedas" yang bias dalam jarak 500 meter dari titik di pusat kota San Francisco. Permintaan ini hanya menampilkan 10 hasil pertama untuk tempat yang buka.
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
menelusuri tempat dengan pengisi daya yang tersedia yang kompatibel dengan kendaraan listrik Anda.
Contoh berikut menunjukkan permintaan untuk konektor pengisian daya EV jenis 1 Tesla dan J1772 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 ditampilkan per halaman. Parameter nextPageToken
dalam isi respons
menyediakan token yang dapat digunakan dalam panggilan berikutnya untuk mengakses halaman hasil
berikutnya.
Contoh berikut menampilkan permintaan untuk "pizza di New York" yang 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 dapat memahami API dan opsi API.
Pilih ikon API, , di sisi kanan halaman.
Jika ingin, luaskan Tampilkan parameter standar dan tetapkan parameter
fields
ke mask kolom.Jika ingin, edit Isi permintaan.
Pilih tombol Execute. Di kotak dialog pop-up, pilih akun yang ingin digunakan untuk membuat permintaan.
Di panel API Explorer, pilih ikon luaskan, , untuk meluaskan jendela API Explorer.