Halaman ini diterjemahkan oleh Cloud Translation API.

Text Search (Baru)

Text Search (New) menampilkan informasi tentang serangkaian tempat berdasarkan suatu string — misalnya "pizza di Bandung" atau "toko sepatu dekat Solo" atau "Jl. Rajawali 3". Layanan ini 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 mungkin cocok dengan bisnis serta alamat. Contoh kueri alamat ambigu adalah alamat yang diformat dengan buruk atau permintaan yang menyertakan komponen non-alamat seperti nama bisnis. Permintaan seperti dua contoh pertama dalam tabel berikut dapat 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.
"ChainRestaurant 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 Jakarta"	Hanya satu perusahaan dengan nama ini di New York; tidak ada alamat yang perlu digunakan untuk membedakannya.
"restoran pizza di Jakarta"	Kueri ini berisi pembatasan lokasinya, dan "restoran pizza" adalah jenis tempat yang ditentukan dengan baik. Metode ini menampilkan beberapa hasil.
"+1 514-670-8700"	Kueri ini berisi nomor telepon. Metode ini akan menampilkan beberapa hasil untuk tempat yang terkait dengan nomor telepon tersebut. Catatan: Untuk hasil terbaik saat melakukan penelusuran melalui nomor telepon, sertakan kode negara diikuti dengan spasi, lalu setel parameter `regionCode` agar sesuai dengan kode negara.

Dengan API Explorer, Anda dapat membuat permintaan secara langsung sehingga Anda dapat memahami opsi API dan API:

Cobalah!

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 (New) menampilkan objek JSON sebagai respons. Dalam respons:

Array places berisi semua tempat yang cocok.
Setiap tempat dalam array direpresentasikan oleh objek Place. Objek Place berisi informasi mendetail tentang satu tempat.
FieldMask yang diteruskan dalam permintaan menentukan daftar kolom yang ditampilkan dalam objek Place.

Objek JSON lengkap 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 atau fields, atau dengan menggunakan header HTTP X-Goog-FieldMask. Tidak ada daftar default 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
```
Catatan: Ruang tidak diizinkan di mana pun dalam daftar kolom.

Gunakan * untuk mengambil semua kolom.
```
X-Goog-FieldMask: *
```
Karakter pengganti "*" memilih semua kolom. Namun, meskipun karakter pengganti tersebut boleh digunakan dalam pengembangan, Google tidak menyarankan penggunaan mask kolom respons karakter pengganti (*) dalam produksi karena besarnya data yang dapat ditampilkan.

Panduan lebih lanjut untuk menggunakan places.iconMaskBaseUri dan places.iconBackgroundColor dapat ditemukan di bagian Place Icons.

Tentukan satu atau beberapa kolom berikut:
- Kolom berikut memicu SKU Text Search (ID Only):
  places.id, places.name^*
  
  ^* Kolom places.name berisi nama resource tempat dalam bentuk: places/PLACE_ID. Gunakan places.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.servesBeer, places.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout
textQuery

String teks yang digunakan untuk menelusuri, misalnya: "restaurant", "123 Main Street", atau "terbaik untuk dikunjungi di Surabaya". API menampilkan kandidat kecocokan berdasarkan string ini dan mengurutkan hasil berdasarkan relevansi yang dirasakan.

Parameter opsional

includedType

Membatasi hasil ke tempat yang cocok dengan jenis yang ditentukan yang ditentukan oleh Tabel A. Hanya satu jenis yang dapat ditentukan. Contoh:
- "includedType":"bar"
- "includedType":"pharmacy"
Catatan: Nilai dalam Tabel B hanya ditampilkan dalam respons. Anda tidak dapat menggunakan nilai dalam Tabel B sebagai filter.
languageCode

Bahasa yang akan 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 ke en. Jika Anda menentukan kode bahasa yang tidak valid, API akan menampilkan error INVALID_ARGUMENT.
- API berupaya sebaik mungkin untuk menyediakan alamat yang dapat dibaca oleh pengguna dan penduduk lokal. Untuk mencapai sasaran tersebut, metode ini menampilkan alamat dalam bahasa lokal, yang ditransliterasi ke skrip yang dapat dibaca oleh pengguna jika perlu, dengan mengamati bahasa pilihan. Semua alamat lainnya akan ditampilkan dalam bahasa pilihan. Komponen alamat semua ditampilkan dalam bahasa yang sama, yang dipilih dari komponen pertama.
- Jika nama tidak tersedia dalam bahasa pilihan, API akan menggunakan bahasa terdekat yang paling cocok.
- Bahasa yang dipilih berpengaruh kecil terhadap kumpulan hasil yang dipilih API untuk ditampilkan, dan urutan tampilannya. 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 atau locationBias, tetapi tidak keduanya. Bayangkan locationRestriction sebagai menentukan wilayah tempat hasil harus berada, dan locationBias menentukan wilayah tempat hasil harus dekat, tetapi bisa saja di luar area tersebut.

Catatan: Jika Anda menghapus locationBias dan locationRestriction, API akan menggunakan pembiasan IP secara default. Dengan pembiasan IP, API menggunakan alamat IP perangkat untuk membiaskan hasilnya.

Catatan: Parameter locationBias dapat diganti jika textQuery berisi lokasi eksplisit seperti Market in Barcelona. Dalam hal ini, locationBias akan diabaikan.

Tentukan wilayah sebagai Area Pandang persegi panjang atau lingkaran.
- Lingkaran ditentukan oleh titik tengah dan radius 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 garis bujur, yang direpresentasikan sebagai dua secara diagonal berlawanan titik rendah dan tinggi. Titik rendah menandai sudut barat daya persegi panjang, dan titik tinggi merepresentasikan sudut timur laut persegi panjang.
  
  Area pandang dianggap sebagai area tertutup, yang berarti area pandang tersebut menyertakan batasnya. Batas garis lintang harus berkisar antara -90 hingga 90 derajat inklusif, dan batas bujur harus memiliki rentang antara -180 hingga 180 derajat:
  - Jika low = high, area tampilan terdiri dari satu titik tersebut.
  - Jika low.longitude > high.longitude, rentang bujur akan dibalik (area pandang melintasi garis bujur 180 derajat).
  - Jika low.longitude = -180 derajat dan high.longitude = 180 derajat, area tampilan akan mencakup semua bujur.
  - Jika low.longitude = 180 derajat dan high.longitude = -180 derajat, rentang bujurnya kosong.
  - Jika low.latitude > high.latitude, rentang lintang akan kosong.
  Baik rendah maupun tinggi harus diisi, dan kotak yang direpresentasikan tidak boleh kosong. Area pandang kosong akan menghasilkan 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
    }
  }
}
```
locationRestriction

Menentukan area yang akan ditelusuri. Hasil di luar area yang ditentukan tidak ditampilkan. Tentukan wilayah sebagai Area Pandang persegi panjang. Lihat deskripsi locationBias untuk informasi tentang menentukan Area Pandang.

Anda dapat menentukan locationRestriction atau locationBias, tetapi tidak keduanya. Bayangkan locationRestriction sebagai menentukan wilayah tempat hasil harus berada, dan locationBias menentukan wilayah tempat hasil harus dekat, tetapi bisa saja di luar area tersebut.

Catatan: Jika Anda menghapus locationBias dan locationRestriction, API akan menggunakan pembiasan IP secara default. Dengan pembiasan IP, API menggunakan alamat IP perangkat untuk membiaskan hasilnya.
maxResultCount

Menentukan jumlah maksimum hasil tempat yang akan ditampilkan. Harus antara 1 dan 20 (default) inklusif.
evOptions

Menentukan parameter untuk mengidentifikasi konektor pengisian daya kendaraan listrik (EV) dan kecepatan pengisian daya yang tersedia.
- connectorTypes
  
  Memfilter menurut jenis konektor pengisian daya kendaraan listrik yang tersedia di suatu tempat. Tempat yang tidak mendukung salah satu jenis konektor akan dikecualikan. Jenis konektor pengisian daya EV yang didukung mencakup pengisi daya gabungan (AC dan DC), pengisi daya Tesla, pengisi daya yang sesuai dengan GB/T (untuk pengisian daya cepat EV di China), dan pengisi daya stopkontak. Untuk informasi selengkapnya, lihat dokumentasi referensi.
- minimumChargingRateKw
  
  Memfilter tempat menurut tingkat pengisian daya kendaraan listrik minimum dalam kilowatt (kW). Semua tempat dengan tarif pengisian daya yang kurang dari tarif pengisian daya minimum akan dikecualikan. 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 penggunanya rata-rata 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 akan menghapus semua hasil dengan rating kurang dari 1,0.
openNow

Jika true, hanya tampilkan tempat yang sedang buka pada saat kueri dikirim. Jika false, tampilkan semua bisnis terlepas dari status bukanya. Tempat yang tidak menetapkan jam buka dalam database Google Places akan ditampilkan jika Anda menetapkan parameter ini ke false.
priceLevels

Membatasi penelusuran ke tempat yang ditandai di tingkat harga tertentu. Setelan default-nya adalah memilih semua tingkat harga.

Tentukan array berisi satu atau beberapa nilai yang ditentukan oleh PriceLevel.

Catatan: PRICE_LEVEL_FREE tidak diizinkan dalam permintaan. Atribut ini hanya digunakan untuk mengisi respons.

Contoh:
```
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
```
rankPreference

Menentukan cara peringkat hasil dalam respons berdasarkan jenis kueri:
- Untuk kueri kategori seperti "Restoran di Bandung", RELEVANCE (peringkat hasil berdasarkan relevansi penelusuran) adalah default. Anda dapat menetapkan rankPreference ke RELEVANCE atau DISTANCE (beri peringkat hasil berdasarkan jarak).
- Untuk kueri non-kategori seperti "Stackdriver View, CA", sebaiknya biarkan rankPreference tidak ditetapkan.
regionCode

Kode wilayah yang digunakan untuk memformat respons, yang ditetapkan sebagai nilai kode CLDR dua karakter. Parameter ini juga dapat memiliki efek bias pada hasil penelusuran. Tidak ada nilai default.

Jika nama negara untuk kolom formattedAddress dalam respons cocok dengan regionCode, kode negara akan dihapus dari formattedAddress. Parameter ini tidak berpengaruh pada adrFormatAddress, yang selalu menyertakan nama negara jika tersedia, atau pada shortFormattedAddress, 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 includeType. Jika ditetapkan ke true, hanya tempat yang cocok dengan jenis tertentu yang ditentukan oleh includeType yang akan ditampilkan. Jika false, respons default dapat berisi tempat yang tidak cocok dengan jenis yang ditentukan.

Contoh Penelusuran Teks

Menemukan tempat berdasarkan string kueri

Contoh berikut menampilkan permintaan Text Search untuk "Spicy Vegetarian Food in 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'

Perlu diperhatikan bahwa header X-Goog-FieldMask menentukan bahwa respons berisi kolom data berikut: places.displayName,places.formattedAddress. Responsnya kemudian berbentuk:

{
  "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 menurut tingkat harga

Gunakan opsi priceLevel untuk memfilter hasil ke restoran yang ditetapkan 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 kolom data places.priceLevel ke respons sehingga berbentuk:

{
  "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 lain untuk menyaring penelusuran Anda, 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 ke suatu area. Bayangkan locationRestriction sebagai menentukan wilayah tempat hasil harus berada, dan locationBias sebagai menentukan wilayah tempat hasil harus dekat, tetapi bisa berada di luar area.

Catatan: Saat menggunakan locationBias, Anda dapat menentukan wilayah sebagai Area Pandang persegi panjang atau lingkaran. Untuk locationRestriction, Anda dapat menentukan wilayah sebagai Area Pandang persegi panjang.

Contoh berikut menampilkan permintaan Text Search untuk "Spicy Vegetarian Food" yang dibiaskan berada 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,
  "maxResultCount": 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'

Telusuri 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 kendaraan listrik Tesla dan J1772 tipe 1 dengan tingkat pengisian daya minimum 10 kW di Mountain View, CA. Hanya empat hasil yang ditampilkan.

curl -X POST -d '{
    "textQuery": "EV Charging Station Mountain View",
    "maxResultCount": 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 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
          }
        ]
      }
    }
  ]
}

Cobalah!

API Explorer memungkinkan Anda membuat permintaan contoh sehingga Anda dapat memahami opsi API dan API.

Pilih ikon API, , di sisi kanan halaman.
Jika ingin, luaskan Show standard parameter dan setel parameter fields ke mask kolom.
Jika perlu, 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.

Text Search (Baru)

Permintaan Text Search

Respons Text Search (Baru)

Parameter wajib

FieldMask

textQuery

Parameter opsional

includedType

languageCode

locationBias

locationRestriction

maxResultCount

evOptions

connectorTypes

minimumChargingRateKw

minRating

openNow

priceLevels

rankPreference

regionCode

strictTypeFiltering

Contoh Penelusuran Teks

Menemukan tempat berdasarkan string kueri

Filter tempat menurut tingkat harga

Menelusuri tempat di suatu area

Telusuri pengisi daya Kendaraan Listrik dengan kecepatan pengisian daya minimum

Cobalah!