Find Place (Lama)

Permintaan Find Place (Lama) menggunakan input teks dan menampilkan tempat. Input dapat berupa jenis data teks Places apa pun, seperti nama, alamat, atau nomor telepon. Permintaan harus berupa string. Permintaan Find Place (Lama) yang menggunakan data non-string seperti koordinat lintang/bujur atau plus code akan menghasilkan error.

Permintaan Find Place (Lama)

Permintaan Find Place (Lama) adalah URL HTTP dengan format berikut:

https://maps.googleapis.com/maps/api/place/findplacefromtext/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 Find Place (Lama). Sesuai dengan standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&).

Parameter yang diperlukan

• input

  String teks yang akan ditelusuri. String ini harus berupa nama tempat, alamat, atau nomor telepon (misalnya, "123 Main Street" atau "City Hall").

• inputtype

  Jenis input. Ini dapat berupa salah satu dari textquery atau phonenumber. Nomor telepon harus memiliki format internasional (diawali dengan tanda plus ("+"), yang diikuti dengan kode negara, lalu nomor telepon itu sendiri). Lihat rekomendasi ITU E.164 untuk mengetahui informasi selengkapnya.

Parameter opsional

• Fields

  Perhatian: Permintaan Place Search (Lama) dan permintaan Place Details (Lama) tidak menampilkan kolom yang sama. Permintaan Place Search (Lama) menampilkan sub-kumpulan kolom yang ditampilkan berdasarkan permintaan Place Details (Lama). Jika kolom yang Anda inginkan tidak ditampilkan oleh Place Search (Lama), Anda dapat menggunakan Place Search (Lama) untuk mendapatkan place_id, lalu menggunakan ID Tempat tersebut untuk membuat permintaan Place Details (Lama). Untuk mengetahui informasi selengkapnya tentang kolom yang tidak tersedia dalam permintaan Place Search (Lama), lihat Dukungan kolom Places API.

  Gunakan parameter fields untuk menentukan daftar jenis data tempat yang dipisahkan koma untuk ditampilkan. Contoh: fields=formatted_address,name,geometry. Gunakan garis miring saat menentukan nilai gabungan. Contoh: opening_hours/open_now.

  Kolom dibagi menjadi tiga kategori penagihan: Basic, Contact, dan Atmosphere. Kolom Basic ditagih dengan tarif dasar, sedangkan kolom Contact dan Atmosphere ditagih dengan tarif lebih tinggi. SKU Basic, Contact, dan Atmosphere dikenai biaya selain SKU dasar (Places Details, Find Place, Nearby Search, atau Text Search) untuk permintaan yang memicunya. Untuk mengetahui informasi selengkapnya, lihat sheet harga.

  Basic

  Kategori Basic mencakup kolom berikut: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (tidak digunakan lagi), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

  Kontak

  Kategori Contact mencakup kolom berikut: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

  Atmosphere

  Kategori Atmosphere mencakup kolom berikut: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

  Catatan: Atribusi, html_attributions, selalu ditampilkan dengan setiap panggilan, terlepas dari apakah kolom telah diminta atau tidak.

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

• locationbias

  Memprioritaskan hasil di area yang ditentukan, dengan menentukan radius plus lintang/bujur, atau dua pasangan lintang/bujur yang mewakili titik-titik persegi panjang. Jika parameter ini tidak ditentukan, API akan menggunakan pembiasan alamat IP secara default.

  • IP bias: Menginstruksikan API untuk menggunakan pembobolan alamat IP. Teruskan string ipbias (opsi ini tidak memiliki parameter tambahan).
  • Lingkaran: String yang menentukan radius dalam meter, ditambah lintang/bujur dalam derajat desimal. Gunakan format berikut: circle:radius@lat,lng.
  • Persegi panjang: String yang menentukan dua pasangan lintang/bujur dalam derajat desimal, yang mewakili titik selatan/barat dan utara/timur persegi panjang. Gunakan format berikut:rectangle:south,west|north,east. Perhatikan bahwa nilai timur/barat digabungkan ke rentang -180, 180, dan nilai utara/selatan dibatasi ke rentang -90, 90.

Contoh Find Place (Lama)

Contoh berikut menunjukkan permintaan Find Place (Lama) untuk "Museum of Contemporary Art Australia", yang menyertakan kolom photos, formatted_address, name, rating, opening_hours, dan geometry:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

Contoh berikut menunjukkan permintaan Find Place (Lama) untuk "Mongolian Grill", menggunakan parameter locationbias untuk memilih hasil dalam radius 2.000 meter dari koordinat yang ditentukan:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

Contoh berikut menunjukkan permintaan Find Place (Lama) untuk nomor telepon. Perhatikan bahwa awalan panggilan internasional "+" telah dienkode menjadi %2B sehingga permintaan ini adalah URL yang sesuai. Jika tidak dienkode, awalan + akan didekode menjadi spasi di server, sehingga menghasilkan pencarian nomor telepon yang tidak valid.

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Respons Find Place (Lama)

Respons Find Place (Lama) hanya berisi jenis data yang ditentukan menggunakan parameter fields, ditambah html_attributions. Contoh berikut menunjukkan respons untuk permintaan Find Place (Lama) untuk "Museum of Contemporary Art Australia", termasuk kolom formatted_address, geometry, name, opening_hours, photos, rating.

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}    

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

    

PlacesFindPlaceFromTextResponse

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