Nearby Search (Lama)

Developer Wilayah Ekonomi Eropa (EEA)

Nearby Search (Lama) memungkinkan Anda menelusuri tempat dalam area yang ditentukan. Anda dapat mempersempit permintaan penelusuran dengan memberikan kata kunci atau menentukan jenis tempat yang Anda telusuri.

Permintaan Nearby Search (Lama)

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

https://maps.googleapis.com/maps/api/place/nearbysearch/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

Parameter tertentu diperlukan untuk memulai permintaan Nearby Search (Lama). Sesuai dengan standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&).

Parameter yang diperlukan

  • lokasi

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

  • 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

  • kata kunci

    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 akan menampilkan bakal hasil berdasarkan string ini dan mengurutkan hasil berdasarkan relevansi yang terlihat.

    Menyertakan informasi lokasi secara eksplisit menggunakan parameter ini dapat bertentangan dengan parameter location, radius, dan rankby, sehingga menyebabkan hasil yang tidak diharapkan.

    Jika parameter ini dihilangkan, tempat dengan business_status CLOSED_TEMPORARILY atau CLOSED_PERMANENTLY tidak akan ditampilkan.

  • 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.

  • 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.

  • nama

    Setara dengan keyword. Nilai di kolom ini digabungkan dengan nilai di kolom keyword dan diteruskan sebagai bagian dari string penelusuran yang sama.

  • 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.

  • rankby

    Menentukan urutan hasil yang dicantumkan. Nilai yang dimungkinkan adalah:

    • prominence (default). Opsi ini menyortir hasil menurut tingkat kepentingannya. Peringkat akan mengutamakan tempat terkemuka dalam radius yang telah ditentukan dibandingkan tempat-tempat terdekat yang cocok tetapi kurang terkemuka. Tempat terkemuka bisa dipengaruhi oleh peringkat suatu tempat dalam indeks Google, popularitas global, dan faktor lainnya. Jika keunggulan ditentukan, parameter radius wajib diisi.
    • distance. Opsi ini membiaskan hasil penelusuran dalam urutan menaik berdasarkan jaraknya dari lokasi yang ditentukan. Jika distance ditentukan, satu atau beberapa keyword, name, atau type diperlukan dan radius tidak diizinkan.

  • jenis

    Membatasi hasil ke tempat yang cocok dengan jenis yang ditentukan. Anda hanya dapat menentukan satu jenis. Jika Anda memberikan lebih dari satu jenis, API akan mengabaikan semua jenis setelah entri pertama.

    • 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 Nearby Search (Lama)

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522%2C151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?keyword=cruise
  &location=-33.8670522%2C151.1957362
  &radius=1500
  &type=restaurant
  &key=YOUR_API_KEY

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

Respons Nearby Search (Lama)

Contoh berikut menunjukkan respons Nearby Search (Lama).

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8587323, "lng": 151.2100055 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85739847010727, "lng": 151.2112436298927 },
                "southwest":
                  { "lat": -33.86009812989271, "lng": 151.2085439701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet",
        "name": "Cruise Bar",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 608,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uECvJIZuXT-uLDYm4DPbrV7gXVPeplbTWUgcOJ6rnfc4bUYCEAwPU_AmXGIaj0PDhWPbmrjQC8hhuXRJQjnA1-iREGEn7I0ZneHg5OP1mDT7lYVpa1hUPoz7cn8iCGBN9MynjOPSUe-UooRrFw2XEXOLgRJ-uKr6tGQUp77CWVocpcoG",
              "width": 1080,
            },
          ],
        "place_id": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "plus_code":
          {
            "compound_code": "46R6+G2 The Rocks, New South Wales",
            "global_code": "4RRH46R6+G2",
          },
        "price_level": 2,
        "rating": 4,
        "reference": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "scope": "GOOGLE",
        "types":
          ["bar", "restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 1269,
        "vicinity": "Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8675219, "lng": 151.2016502 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86614532010728, "lng": 151.2031259298927 },
                "southwest":
                  { "lat": -33.86884497989272, "lng": 151.2004262701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Sydney Harbour Dinner Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 835,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEBVsYnNcrpRixtrlHBztigZh70CwYkNWZzQnqJ39SjeBo_wvgKf-kXc6tgaMLBdQrRKmxmSKjOezoZrv-sHKVbTX0OI48HBqYYVnQiZQ-WGeuQDsLEPwX7LaVPa68nUAxX114Zpqt7bryoO9wL4qXdgEnopbOp5WWLALhKEHoIEH7f7",
              "width": 1200,
            },
          ],
        "place_id": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "plus_code":
          {
            "compound_code": "46J2+XM Sydney, New South Wales",
            "global_code": "4RRH46J2+XM",
          },
        "rating": 4.8,
        "reference": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 9,
        "vicinity": "32 The Promenade, Sydney",
      },
      // ...
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Cruise Bar</name>
  <vicinity>Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8587323</lat>
    <lng>151.2100055</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8600981</lat>
     <lng>151.2085440</lng>
    </southwest>
    <northeast>
     <lat>-33.8573985</lat>
     <lng>151.2112436</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png</icon>
  <reference>ChIJi6C1MxquEmsR9-c-3O48ykI</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEALIq4sgBHhIYWWapOH2NV1T2I7YdOiLzEH7z-483I764cId1sZkbzSq-hVYTk1PQeaHuZzlRfA7-ilwJ3QWon4b37ePd-PBwZbOwFZHxhYs0Cs7jRSgMHWfOzGivp6ZFG4iupyz50qS5pBZT1WbA2ufacTq_U21TtgffQD31wKRPQk</photo_reference>
   <width>1080</width>
   <height>608</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112582655193348962755&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>1269</user_ratings_total>
  <place_id>ChIJi6C1MxquEmsR9-c-3O48ykI</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46R6+G2</global_code>
   <compound_code>46R6+G2 The Rocks, New South Wales</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/bar_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Sydney Harbour Dinner Cruises</name>
  <vicinity>32 The Promenade, Sydney</vicinity>
  <type>tourist_attraction</type>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675219</lat>
    <lng>151.2016502</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8688450</lat>
     <lng>151.2004263</lng>
    </southwest>
    <northeast>
     <lat>-33.8661453</lat>
     <lng>151.2031259</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.8</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJM1mOVTS6EmsRKaDzrTsgids</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB5jH7GXdcozv1Y5HX18syo4f128S58NVUnqBbLJMpWbC39K49wp-wzsLOsUT8QKDaag6ISFL8hl1vVuig4jkc5fMMkWKiqw5PY-ebcWZ5tI3gEXEYGGoG_mDAulaMLudUpSwgBx2_RLnA0SSiugqqQUTYlkGyCZSe8HSyngVczy6XN</photo_reference>
   <width>1200</width>
   <height>835</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/109764923610545394994&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>9</user_ratings_total>
  <place_id>ChIJM1mOVTS6EmsRKaDzrTsgids</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+XM</global_code>
   <compound_code>46J2+XM Sydney, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
</PlaceSearchResponse>

PlacesNearbySearchResponse

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 akan 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