Text Search (Lama)

Developer Wilayah Ekonomi Eropa (EEA)

Text Search (Lama) menampilkan informasi tentang serangkaian tempat berdasarkan suatu string — misalnya "pizza di Bandung" atau "toko sepatu di dekat Solo" atau "Jl. Rajawali 3". Layanan ini merespons dengan daftar tempat yang cocok dengan string teks dan bias lokasi yang telah ditetapkan.

Text Search (Lama) tidak ditujukan untuk kueri yang ambigu, termasuk yang berikut:

Jenis kueri Contoh
Terlalu banyak konsep atau batasan, seperti nama beberapa tempat, jalan, atau kota dalam satu kueri "Market Street San Francisco San Jose Airport"
Elemen alamat pos tidak ditampilkan di Google Maps "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"
Nama bisnis, jaringan, atau kategori yang digabungkan dengan lokasi tempat entitas ini tidak tersedia "Tesco di dekat Dallas, Texas"
Kueri ambigu dengan beberapa interpretasi "Pengembalian pengisi daya"
Nama historis yang tidak lagi digunakan "Middlesex United Kingdom"
Elemen atau niat non-geospasial "Berapa banyak perahu di Ventura Harbor?"
Nama tidak resmi atau nama unik "The Jenga"
"The Helter Skelter"
Koordinat lintang dan bujur "37.422131,-122.084801"

Respons penelusuran menyertakan daftar tempat. Anda bisa mengirim permintaan Place Details untuk informasi selengkapnya tentang tempat dalam respons tersebut.

Permintaan Text Search (Lama)

Permintaan Text Search (Lama) adalah URL HTTP dengan format berikut:

https://maps.googleapis.com/maps/api/place/textsearch/output?parameters

dengan output dapat berupa salah satu dari nilai berikut:

  • json (direkomendasikan) menunjukkan output dalam JavaScript Object Notation (JSON)
  • xml menunjukkan output sebagai XML

Diperlukan parameter tertentu untuk memulai permintaan penelusuran. Sesuai dengan standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&).

Parameter yang diperlukan

  • kueri

    String teks yang digunakan untuk menelusuri, misalnya: "restaurant" atau "123 Main Street". String ini harus berupa nama tempat, alamat, atau kategori tempat usaha. Jenis input lainnya dapat menghasilkan error dan tidak dijamin akan menampilkan hasil yang valid. Layanan Google Places menampilkan bakal hasil berdasarkan string ini dan mengurutkan hasil berdasarkan relevansi yang terlihat.

  • radius

    Menentukan jarak (dalam meter) untuk menampilkan hasil tempat. Anda dapat membiaskan hasil ke lingkaran yang ditentukan dengan meneruskan parameter location dan radius. Tindakan ini akan menginstruksikan layanan Places agar memprioritaskan untuk menampilkan hasil dalam lingkaran tersebut; hasil di luar area yang ditentukan mungkin tetap ditampilkan.

    Radius akan otomatis dibatasi ke nilai maksimum, bergantung pada jenis penelusuran dan parameter lainnya.

    • Autocomplete: 50.000 meter
    • Nearby Search:
      • dengan keyword atau name: 50.000 meter
      • tanpa keyword atau name
        • Hingga 50.000 meter, disesuaikan secara dinamis berdasarkan kepadatan area, terlepas dari parameter rankby.
        • Saat menggunakan rankby=distance, parameter radius tidak akan diterima, dan akan menghasilkan INVALID_REQUEST.
    • Query Autocomplete: 50.000 meter
    • Text Search: 50.000 meter

Parameter opsional

  • bahasa

    Bahasa yang digunakan untuk menampilkan hasil.

    • Lihat daftar bahasa yang didukung. Google sering memperbarui bahasa yang didukung, sehingga daftar ini mungkin tidak lengkap.
    • Jika language tidak diberikan, API akan mencoba menggunakan bahasa pilihan seperti yang ditentukan di header Accept-Language.
    • API ini berupaya sebaik mungkin untuk memberikan alamat yang dapat dibaca oleh pengguna dan penduduk setempat. Untuk mencapai tujuan tersebut, API ini menampilkan alamat jalan dalam bahasa lokal, yang ditransliterasikan ke skrip yang dapat dibaca oleh pengguna jika perlu, dengan mengamati bahasa pilihan. Semua alamat lainnya ditampilkan dalam bahasa pilihan. Komponen alamat semuanya ditampilkan dalam bahasa yang sama, yang dipilih dari komponen pertama.
    • Jika nama tidak tersedia dalam bahasa pilihan, API akan menggunakan kecocokan terdekat.
    • Bahasa pilihan memiliki pengaruh kecil pada kumpulan hasil yang dipilih API untuk ditampilkan, dan urutan kemunculannya. 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. Misalnya, utca dan tér adalah sinonim untuk jalan dalam bahasa Hungaria.

  • lokasi

    Titik di sekitar tempat informasi tempat akan diambil. Nilai ini harus ditentukan sebagai latitude,longitude.

    Parameter location dapat diganti jika query berisi lokasi eksplisit seperti Market in Barcelona. Penggunaan tanda kutip di sekitar kueri juga dapat memengaruhi bobot yang diberikan pada location dan radius.

  • maxprice

    Membatasi hasil hanya ke tempat yang berada dalam rentang yang ditentukan. Nilai yang valid berkisar antara 0 (paling terjangkau) hingga 4 (paling mahal), inklusif. Jumlah persis yang ditunjukkan oleh nilai tertentu akan bervariasi dari satu wilayah ke wilayah lainnya.

  • minprice

    Membatasi hasil hanya ke tempat yang berada dalam rentang yang ditentukan. Nilai yang valid berkisar antara 0 (paling terjangkau) hingga 4 (paling mahal), inklusif. Jumlah persis yang ditunjukkan oleh nilai tertentu akan bervariasi dari satu wilayah ke wilayah lainnya.

  • opennow

    Hanya menampilkan tempat yang sedang buka pada saat kueri dikirim. Tempat yang tidak menetapkan jam buka dalam database Google Places tidak akan ditampilkan jika Anda menyertakan parameter ini dalam kueri.

  • pagetoken

    Menampilkan hingga 20 hasil dari penelusuran yang dijalankan sebelumnya. Menetapkan parameter pagetoken akan menjalankan penelusuran dengan parameter yang sama seperti yang digunakan sebelumnya — semua parameter selain pagetoken akan diabaikan.

  • region

    Kode wilayah, yang ditetapkan sebagai nilai dua karakter ccTLD ("domain level teratas"). Sebagian besar kode ccTLD 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 "The United Kingdom of Great Britain and Northern Ireland").

  • jenis

    Membatasi hasil ke tempat yang cocok dengan jenis yang ditentukan. Hanya satu jenis yang dapat ditentukan. Jika lebih dari satu jenis disediakan, semua jenis setelah entri pertama akan diabaikan.

    • type=hospital|pharmacy|doctor menjadi type=hospital
    • type=hospital,pharmacy,doctor diabaikan sepenuhnya

    Lihat daftar jenis yang didukung.

    Catatan: Menambahkan keyword dan type dengan nilai yang sama (keyword=cafe&type=cafe atau keyword=parking&type=parking) dapat menghasilkan ZERO_RESULTS.

Contoh Text Search (Lama)

Catatan: Dalam contoh ini, Anda harus mengganti key dengan kunci API Anda sendiri agar permintaan berfungsi di aplikasi Anda.

Contoh dasar

Contoh berikut menunjukkan penelusuran restoran di dekat Sydney.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants%20in%20Sydney&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=restaurants%20in%20Sydney
  &key=YOUR_API_KEY

Contoh alamat tidak lengkap

Contoh berikut menunjukkan penelusuran untuk alamat yang tidak lengkap, dalam hal ini, alamat yang tidak menyertakan kota, negara bagian, atau negara.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=123%20main%20street
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "Main St, Denver, CO 80238, USA",
        "geometry":
          {
            "location": { "lat": 39.782267, "lng": -104.8919341 },
            "viewport":
              {
                "northeast":
                  { "lat": 39.78361682989273, "lng": -104.8905842701073 },
                "southwest":
                  { "lat": 39.78091717010729, "lng": -104.8932839298927 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Main St",
        "place_id": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "reference": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "types": ["route"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Main St</name>
  <type>route</type>
  <formatted_address>Main St, Denver, CO 80238, USA</formatted_address>
  <geometry>
   <location>
    <lat>39.7822670</lat>
    <lng>-104.8919341</lng>
   </location>
   <viewport>
    <southwest>
     <lat>39.7809172</lat>
     <lng>-104.8932839</lng>
    </southwest>
    <northeast>
     <lat>39.7836168</lat>
     <lng>-104.8905843</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJIS85_gd7bIcRJIGEPue1cJI</reference>
  <place_id>ChIJIS85_gd7bIcRJIGEPue1cJI</place_id>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

Contoh bias lokasi

Contoh berikut menunjukkan penelusuran untuk alamat tidak lengkap yang sama pada contoh sebelumnya, dan menyertakan parameter location dan radius untuk membiaskan hasil ke wilayah yang diinginkan.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&location=42.3675294%2C-71.186966&radius=10000&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?location=42.3675294%2C-71.186966
  &query=123%20main%20street
  &radius=10000
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "123 Main St, Boston, MA 02110, USA",
        "geometry":
          {
            "location": { "lat": 42.3744917, "lng": -71.0634802 },
            "viewport":
              {
                "northeast":
                  { "lat": 42.37581642989272, "lng": -71.06219107010727 },
                "southwest":
                  { "lat": 42.37311677010727, "lng": -71.06489072989272 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "123 Main St",
        "place_id": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "plus_code":
          {
            "compound_code": "9WFP+QJ Boston, Massachusetts",
            "global_code": "87JC9WFP+QJ",
          },
        "reference": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "types": ["street_address"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>123 Main St</name>
  <type>street_address</type>
  <formatted_address>123 Main St, Boston, MA 02110, USA</formatted_address>
  <geometry>
   <location>
    <lat>42.3744917</lat>
    <lng>-71.0634802</lng>
   </location>
   <viewport>
    <southwest>
     <lat>42.3731168</lat>
     <lng>-71.0648907</lng>
    </southwest>
    <northeast>
     <lat>42.3758164</lat>
     <lng>-71.0621911</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJd_ueCe1w44kRD_KFuN5w5nA</reference>
  <place_id>ChIJd_ueCe1w44kRD_KFuN5w5nA</place_id>
  <plus_code>
   <global_code>87JC9WFP+QJ</global_code>
   <compound_code>9WFP+QJ Boston, Massachusetts</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

Respons Text Search (Lama)

Respons penelusuran ditampilkan dalam format yang ditunjukkan oleh flag output dalam jalur permintaan URL.

Contoh berikut menunjukkan respons Text Search (Lama).

JSON

{
  "html_attributions": [],
  "next_page_token": "Aap_uEAHsgFErpxZrytW1mgKsefD327VCf0OgNF9vpXPwTOG6AGhEZpGgMgofSzgCahevXhneCe9M9H24SOuE4ZcaE0ZR01gVykQZ6EoDnlWEQvXBXe6z0sgF5MQo7qBb6uD4VHKDLhgR59Lb86BzTHJzTzbm61OAPvyInZoaQxK8-oEf2PShZT7XRJKoF5nISbwvU_-RomwGDVi27oj0fToIyV-Vj2ftJw8ZUPbdGGCbcDolQyAwj11Dy2aaeK4SGwg2mO5Akxa7fCze2RJ0GCAvXXp7omTFDy_47OXsFgDPfzluc7mEb5VlzlIMZ0eWQ8VeNigtv-XZZG0f3HSo81Yeq3QhXedJ5oNE1XCwyMly3YVgw_h3amOzAOuDigF1pgFnfGyzxD8vr2bfbPTNvA9l7IJ8Q",
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "1 Macquarie St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8592041, "lng": 151.2132635 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85786707010728, "lng": 151.2147093298927 },
                "southwest":
                  { "lat": -33.86056672989272, "lng": 151.2120096701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Aria Restaurant Sydney",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4032,
              "html_attributions":
                [
                  'Dohyun Kim',
                ],
              "photo_reference": "Aap_uED7B83PoQ1wNgzYcFZEOw1P2DqNjlaqiXxo-r4F_NaR27uV2OiIvijkI6RYyfiiHYo9UqjnZkRtZaNTk4C6Ickh3k3stsSvBU0KfLtFow-oRujSYYChYwiYhVyP27omLzQQjafhJ2N3LJbjcMxSePKXsQzYCqmOLWg0E9mSExMJ4aM",
              "width": 3024,
            },
          ],
        "place_id": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "plus_code":
          {
            "compound_code": "46R7+88 Sydney, New South Wales, Australia",
            "global_code": "4RRH46R7+88",
          },
        "price_level": 4,
        "rating": 4.5,
        "reference": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 1681,
      },
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "15 Bligh St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8651396, "lng": 151.2104533 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86384167010728, "lng": 151.2118993298927 },
                "southwest":
                  { "lat": -33.86654132989272, "lng": 151.2091996701073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Restaurant Hubert",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 683,
              "html_attributions":
                [
                  'Ashley Hughes',
                ],
              "photo_reference": "Aap_uEB41WOb_Nl8I8py4D6uXoLHzVYtFZZcucYdYAN1FtzXBnAu59xXrxk5tekoktAbklwmHeSFfdnTCWgHRZ1C5Azp9AMCP9GRGV1f2Z1-5kjsVgnYPiq82JoueSUdCSQJFabyL0cagtcGaFKetVi7DmUIHDQknEPCh_cpCbdOMw4Bkq5q",
              "width": 1024,
            },
          ],
        "place_id": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "plus_code":
          {
            "compound_code": "46M6+W5 Sydney, New South Wales, Australia",
            "global_code": "4RRH46M6+W5",
          },
        "price_level": 3,
        "rating": 4.6,
        "reference": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 2393,
      },
      // ...
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Aria Restaurant Sydney</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>1 Macquarie St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8592041</lat>
    <lng>151.2132635</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8605667</lat>
     <lng>151.2120097</lng>
    </southwest>
    <northeast>
     <lat>-33.8578671</lat>
     <lng>151.2147093</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.5</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJdxxU1WeuEmsR11c4fswX-Io</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDOK3C-umU4a2um8NR1G_b_MNPEG1ogm0PLp49myXaj0AD2aT60YrNlbrwnvg2VBrCmE2kBsuDmwZgXL8V-vU2ToVhNgp3A8zAjtx15slWyCxm3WCvWFEPE-_eBoj0Dlh83k_oWPN65B0blYM-qXLBY1PJZbq14gOUXabf31PSo1yA</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112033760018394328606&quot;&gt;Dohyun Kim&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>4</price_level>
  <user_ratings_total>1681</user_ratings_total>
  <place_id>ChIJdxxU1WeuEmsR11c4fswX-Io</place_id>
  <plus_code>
   <global_code>4RRH46R7+88</global_code>
   <compound_code>46R7+88 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Restaurant Hubert</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>15 Bligh St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8651396</lat>
    <lng>151.2104533</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8665413</lat>
     <lng>151.2091997</lng>
    </southwest>
    <northeast>
     <lat>-33.8638417</lat>
     <lng>151.2118993</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.6</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJF5-RdGquEmsR5rN_H74uSqQ</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDhALUBAcrBEprGmkq0_kj9kC4IEWod9h0PZBu-A1mXPN_ZfylpiDXRWxOtuONEFQIqjREf7C28LQDjzqVl4ZD0gZUk4Y0JHPDWaTlfVwijaPfw221p175Sk4po7rB2t7HgjQF2c5O12FYnvNzRiCrkOjr4xroJgzcnp1LV0y8w7gtb</photo_reference>
   <width>1024</width>
   <height>683</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/113719639442868633401&quot;&gt;Ashley Hughes&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>3</price_level>
  <user_ratings_total>2393</user_ratings_total>
  <place_id>ChIJF5-RdGquEmsR5rN_H74uSqQ</place_id>
  <plus_code>
   <global_code>4RRH46M6+W5</global_code>
   <compound_code>46M6+W5 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
 <next_page_token>Aap_uEC8n0Fzu2WsA7IqaEJty09klsnvXEYZe0aL8dIiZx3fOOfo1xYHZR00qrq-obJbYY9YRkftL-Pv__rQ-efJHSxv19gDtol2ARoY9wpi0ENg-vUAkDVt2W0mOqDy4Kjz9rm5-tzk6fhKR6r4wbLkdgXbKLuNM7KEhsjspU0RC5jQZa4FK_cM9qeUPx5IkPdAa11b9EJwKPEy-ixe77eXeRbEzDYhC5rhylkoOGbF1mHVJVxr--u-Ihe0YaFogaWDx50BcCcMN-eDetaUBJwXDnzHxtirIRF5C_yFavCzWcFn5TOC_z9Ltc-U0L5zbv3lQ7Z6kfVuOeKp4u5_lEHwfz-LuHyETKE6QwQypJUPS3AS8BFs2pYm9r_ruao6YVYsFfDGs1-9QPsVUeSjCN3NuRvbkA</next_page_token>
</PlaceSearchResponse>

PlacesTextSearchResponse

Kolom Wajib Jenis Deskripsi
required Array<string>

Dapat berisi kumpulan atribusi tentang listingan ini yang harus ditampilkan kepada pengguna (beberapa listingan mungkin tidak memiliki atribusi).

required Array<Place>

Berisi array tempat.

Permintaan Place Search menampilkan sub-kumpulan kolom yang ditampilkan berdasarkan permintaan Place Details. Jika kolom yang Anda inginkan tidak ditampilkan oleh Place Search, Anda dapat menggunakan Place Search untuk mendapatkan place_id, lalu menggunakan ID Tempat tersebut untuk membuat permintaan Place Details.

Lihat Tempat untuk mengetahui informasi selengkapnya.
required PlacesSearchStatus

Berisi status permintaan, dan mungkin berisi informasi proses debug untuk membantu Anda melacak penyebab kegagalan permintaan.

Lihat PlacesSearchStatus untuk mengetahui informasi selengkapnya.

opsional string

Jika layanan menampilkan kode status selain OK<, mungkin ada kolom error_message tambahan dalam objek respons. Kolom ini berisi informasi yang lebih mendetail tentang alasan di balik kode status yang diberikan. Kolom ini tidak selalu ditampilkan, dan kontennya dapat berubah sewaktu-waktu.

opsional Array<string>

Jika layanan menampilkan informasi tambahan tentang spesifikasi permintaan, mungkin ada kolom info_messages tambahan dalam objek respons. Kolom ini hanya ditampilkan untuk permintaan yang berhasil. ID ini mungkin tidak selalu ditampilkan, dan kontennya dapat berubah.

next_page_token

opsional string

Berisi token yang dapat digunakan untuk menampilkan hingga 20 hasil tambahan. next_page_token tidak akan ditampilkan jika tidak ada hasil tambahan yang dapat ditampilkan. Jumlah hasil maksimum yang dapat ditampilkan adalah 60. Ada penundaan singkat antara saat next_page_token dikeluarkan dan saat token tersebut menjadi valid.

PlacesSearchStatus

Kode status yang ditampilkan oleh layanan.

  • OK yang menunjukkan bahwa permintaan API berhasil.
  • ZERO_RESULTS yang menunjukkan bahwa penelusuran berhasil, tetapi tidak menampilkan hasil. Hal ini dapat terjadi jika penelusuran diteruskan ke latlng di lokasi terpencil.
  • INVALID_REQUEST yang menunjukkan bahwa permintaan API salah format, umumnya karena parameter kueri yang diperlukan (location atau radius) tidak ada.
  • OVER_QUERY_LIMIT yang menunjukkan salah satu hal berikut:
    • Anda telah melampaui batas QPS.
    • Penagihan belum diaktifkan di akun Anda.
    • Kredit bulanan sebesar $200, atau batas penggunaan yang ditentukan sendiri, telah terlampaui.
    • Metode pembayaran yang diberikan sudah tidak valid (misalnya kartu kredit yang sudah tidak berlaku).
    Lihat FAQ Maps untuk mengetahui informasi selengkapnya tentang cara mengatasi error ini.
  • REQUEST_DENIED yang menunjukkan bahwa permintaan Anda ditolak, biasanya karena:
    • Permintaan tidak memiliki kunci API.
    • Parameter key tidak valid.
  • UNKNOWN_ERROR menunjukkan error yang tidak dikenal.

Tempat

Respons Place Search menampilkan sub-kumpulan kolom Place berikut. Tidak semua atribut tersedia untuk semua jenis tempat. Untuk mengambil kolom yang tidak ditampilkan oleh Place Search, seperti address_components, formatted_phone_number, reviews, atau website, teruskan place_id yang ditampilkan dalam permintaan Place Details (Lama). Untuk ketersediaan kolom dan tingkat harga di seluruh endpoint, lihat Kolom Data Tempat (Lama).

Kolom Jenis Deskripsi
business_status string Menunjukkan status operasional tempat, jika berupa bisnis: OPERATIONAL, CLOSED_TEMPORARILY, atau CLOSED_PERMANENTLY. Dihilangkan jika tidak ada data status.
formatted_address string Alamat tempat ini yang dapat dibaca manusia. Ditampilkan oleh Text Search (Lama) dan Find Place (Lama). Jangan mengurai alamat berformat secara terprogram; minta address_components di Place Details (Lama).
geometry Geometry Berisi location yang di-geocode dengan koordinat lat dan lng, serta viewport pilihan dengan batas northeast dan southwest.
icon string URL ikon yang disarankan yang dapat Anda tampilkan saat menunjukkan hasil ini di peta.
icon_background_color string Kode warna heksadesimal default untuk kategori tempat.
icon_mask_base_uri string URL dasar ikon yang direkomendasikan, tanpa ekstensi jenis file SVG atau PNG.
name string Nama yang dapat dibaca manusia untuk hasil yang ditampilkan. Untuk hasil establishment, nilai ini biasanya adalah nama bisnis yang dikanonisasi.
opening_hours PlaceOpeningHours Informasi jam buka. Endpoint Place Search hanya menampilkan subkolom boolean open_now; minta opening_hours di Place Details (Lama) untuk periods dan weekday_text.
permanently_closed boolean Tidak digunakan lagi: Gunakan business_status untuk memeriksa status operasional bisnis.
photos Array<PlacePhoto> Array objek PlacePhoto, masing-masing berisi photo_reference, height, width, dan html_attributions. Untuk mengetahui detail penggunaan, lihat Foto Tempat (Lama).
place_id string Sebuah identifier tekstual yang secara unik mengidentifikasi tempat. Teruskan ID ini dalam parameter place_id dari permintaan Place Details (Lama). Lihat ringkasan ID tempat.
plus_code PlusCode Referensi lokasi yang dienkode yang berasal dari koordinat lintang dan bujur, yang berisi global_code dan compound_code opsional.
price_level integer Tingkat harga tempat dalam skala dari 0 hingga 4, dari yang paling murah hingga yang paling mahal. Lihat price_level.
rating number Rating tempat, dari 1.0 hingga 5.0, berdasarkan gabungan ulasan pengguna.
reference string Tidak digunakan lagi: Gunakan place_id sebagai gantinya.
scope string Tidak digunakan lagi: Menunjukkan cakupan place_id, yang selalu berupa GOOGLE. Ditampilkan oleh Nearby Search (Lama).
types Array<string> Array jenis fitur yang mendeskripsikan hasil yang diberikan. Lihat Jenis Tempat (Lama).
user_ratings_total integer Jumlah total rating, dengan atau tanpa teks ulasan, untuk tempat ini.
vicinity string Alamat yang disederhanakan untuk tempat, termasuk nama jalan, nomor jalan, dan lokalitas, tanpa negara bagian atau provinsi, kode pos, atau negara. Ditampilkan oleh Nearby Search (Lama).

Mengakses Hasil Tambahan

Secara default, setiap respons menampilkan hingga 20 hasil establishment per kueri; namun, setiap penelusuran dapat menampilkan hingga 60 hasil, yang terbagi dalam tiga halaman. Jika penelusuran Anda akan menampilkan lebih dari 20, respons penelusuran akan menyertakan nilai tambahan — next_page_token. Teruskan nilai next_page_token ke parameter pagetoken dari permintaan baru untuk melihat kumpulan hasil berikutnya.

  • Jika next_page_token bernilai null, atau tidak ditampilkan, berarti tidak ada hasil lebih lanjut.
  • Mencoba ulang permintaan dengan next_page_token yang sama akan menampilkan halaman hasil berikutnya.
  • Menetapkan pagetoken akan menyebabkan parameter lain diabaikan.
  • Anda dapat meminta halaman baru hingga dua kali setelah kueri awal.
  • Setiap permintaan, termasuk permintaan yang menggunakan next_page_token, dihitung sebagai satu permintaan terhadap batas penggunaan Anda dan dikenai biaya secara terpisah.
  • Ada penundaan beberapa detik antara saat next_page_token dikeluarkan, dan saat token tersebut akan menjadi valid. Meminta halaman berikutnya sebelum tersedia akan menampilkan respons INVALID_REQUEST. Permintaan dengan next_page_token selalu dikenai biaya.

Misalnya, dalam kueri di bawah, kita menelusuri restoran di dekat Darling Harbour, di Sydney Australia, dan memberi peringkat hasil berdasarkan jarak. Anda dapat melihat bahwa respons berisi properti next_page_token.

{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [...]
   "status" : "OK"
}

Untuk melihat kumpulan hasil berikutnya, Anda dapat mengirimkan kueri baru, dengan meneruskan hasil next_page_token ke parameter pagetoken. Contoh: 

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY