Text Search (Baru)

Pilih platform: Android iOS JavaScript Layanan Web

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.
"[phone]"	Kueri ini berisi nomor telepon. Operator ini mengembalikan banyak hasil untuk tempat yang terkait dengan nomor telepon tersebut. Catatan: Untuk hasil terbaik saat melakukan penelusuran di nomor telepon, sertakan kode negara diikuti spasi, dan setel regionCode yang sesuai dengan kode negara.

API Explorer memungkinkan Anda membuat permintaan langsung sehingga Anda dapat membiasakan diri dengan API dan Opsi 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 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 . Objek Place 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 atau fields, atau dengan menggunakan header HTTP X-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

  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 boleh digunakan dalam pengembangan. Google tidak menyarankan mask kolom respons karakter pengganti (*) dalam produksi karena banyaknya besar yang dapat ditampilkan.
  Panduan lebih lanjut untuk menggunakan places.iconMaskBaseUri dan places.iconBackgroundColor dapat ditemukan di Bagian Ikon Tempat.

  Tentukan satu atau beberapa kolom berikut:

  • Kolom berikut memicu SKU Text Search (Khusus ID):

    places.attributions, places.id, places.name^* nextPageToken
    
    ^* 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.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"
  Catatan: Nilai dalam Tabel B hanya ditampilkan dalam respons. Anda tidak dapat menggunakan nilai di Tabel B sebagai filter.

• 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 ke en. Jika Anda menetapkan kode bahasa yang tidak valid, API menampilkan error INVALID_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 atau locationBias, tetapi tidak keduanya. Anggap locationRestriction sebagai menentukan wilayah tempat hasil harus berada dalam cakupan, dan locationBias sebagai yang menetapkan wilayah di mana hasilnya harus dekat tetapi bisa berada di luar area tersebut.

  Catatan: Jika Anda menghilangkan keduanya locationBias dan locationRestriction, lalu API menggunakan pembiasan IP secara {i>default<i}. Dengan pembiasan IP, API menggunakan atribut Alamat IP untuk mencondongkan hasilnya.
  Catatan: Parameter locationBias dapat harus diganti jika textQuery berisi lokasi eksplisit seperti Market in Barcelona. Dalam hal ini, locationBias diabaikan.

  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 dan high.longitude = 180 derajat, area pandang mencakup semua bujur.
    • Jika low.longitude = 180 derajat dan high.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
        }
      }
    }

• 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 atau locationBias, tetapi tidak keduanya. Anggap locationRestriction sebagai menentukan wilayah tempat hasil harus berada dalam cakupan, dan locationBias sebagai yang menetapkan wilayah di mana hasilnya harus dekat tetapi bisa berada di luar area tersebut.

  Catatan: Jika Anda menghilangkan keduanya locationBias dan locationRestriction, lalu API menggunakan pembiasan IP secara {i>default<i}. Dengan pembiasan IP, API menggunakan alamat IP perangkat untuk membuat hasil menjadi bias.

• maxResultCount (tidak digunakan lagi)

  Tidak digunakan lagi: Kolom ini tidak digunakan lagi dan digantikan oleh pageSize. Jika maxResultCount dan pageSize ditentukan, pageSize akan digunakan dan maxResultCount akan diabaikan.

  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 menyertakan nextPageToken yang Anda dapat diteruskan ke permintaan berikutnya untuk mengakses halaman berikutnya.

  Catatan: Jika maxResultCount adalah 0 atau tidak ditentukan, API akan menampilkan 20 hasil per halaman secara default. Jika maxResultCount lebih besar dari 20, API tidak akan menampilkan lebih dari 20 hasil per halaman.

• 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. Jika false, 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 ke false.

• 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 menyertakan nextPageToken yang Anda dapat diteruskan ke permintaan berikutnya untuk mengakses halaman berikutnya.

  Catatan: Jika pageSize adalah 0 atau tidak ditentukan, API akan menampilkan 20 hasil per halaman secara default. Jika pageSize lebih besar dari 20, API tidak akan menampilkan lebih dari 20 hasil per halaman.

• 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

  Catatan: PRICE_LEVEL_FREE adalah tidak diizinkan dalam sebuah permintaan. Kolom ini hanya digunakan untuk mengisi respons.

  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 menetapkan rankPreference ke RELEVANCE atau DISTANCE (peringkat hasil menurut jarak).
  • Untuk kueri non-kategori seperti "Mountain View, CA", sebaiknya Anda membiarkan rankPreference tidak disetel.

• 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 dengan regionCode, kode negara dihilangkan dari formattedAddress. Parameter ini tidak berpengaruh pada adrFormatAddress, yang selalu menyertakan negara nama 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 includedType. Jika ditetapkan ke true, hanya tempat yang cocok dengan jenis yang ditentukan oleh includeType 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.

Catatan: Parameter penajaman ini hanya berlaku ke kueri seperti "Restoran di New York City" di mana parameter membantu mengurangi jumlah hasil penelusuran berdasarkan opsi yang ditentukan. Dengan menerapkan parameter ke jenis kueri lain—misalnya, kueri geografis seperti "Mountain View, CA" atau "New York City"—sebenarnya dapat menghasilkan penyaringan hasil yang bermakna atau mengurangi jumlah hasil yang bermakna.

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.

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

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

Catatan: Semua parameter selain maxResultCount, pageSize, dan pageToken harus sama dengan permintaan sebelumnya. Jika tidak, API akan menampilkan INVALID_ARGUMENT error.

Cobalah!

API Explorer memungkinkan Anda membuat contoh permintaan sehingga Anda bisa membiasakan diri dengan API dan opsi API.

1. Pilih ikon API, , di sisi kanan halaman.

2. Jika ingin, luaskan Show standar parameter dan setel fields parameter ke kolom penyamaran.

3. Jika ingin, edit Isi permintaan.

4. Pilih tombol Execute. Di kotak dialog pop-up, pilih akun yang yang ingin Anda gunakan untuk membuat permintaan.

5. Di panel API Explorer, pilih ikon luaskan, , untuk meluaskan jendela API Explorer.