Pilih versi API Anda

Places API mendukung dua versi API: Places API adalah API yang sudah ada dan Places API (Baru) adalah versi API generasi berikutnya.

Dengan dirilisnya Places API (Baru), tugas pertama Anda adalah menentukan kumpulan API mana yang akan digunakan. Hal ini berlaku jika Anda adalah pelanggan baru atau pelanggan lama yang sudah menggunakan API ini. Gunakan panduan ini untuk memahami perbedaan utama antara kedua API tersebut.

Daftar API

Tabel berikut mencantumkan kedua kumpulan API. Jika Anda adalah pelanggan lama, gunakan tabel ini untuk menentukan API baru yang menggantikan API yang saat ini Anda gunakan.

Places API Places API (Baru) Catatan
Find Place Penelusuran Teks (Baru) Tidak ada versi baru Find Place. Text Search (Baru) telah menggantikannya.
Nearby Search Nearby Search (Baru) Semua permintaan menggunakan API yang ada dan menyertakan kueri teks harus menggunakan Text Search (Baru) karena Nearby Search (Baru) tidak mendukung input teks.
Penelusuran Teks Penelusuran Teks (Baru)
Place Details Place Details (Baru)
Foto Tempat Foto Tempat (Baru)
Pelengkapan Otomatis Tempat Pelengkapan Otomatis (Baru) Dalam Pratinjau
Pelengkapan Otomatis Kueri Pelengkapan Otomatis (Baru) Kemampuan yang ditambahkan ke versi Pratinjau Autocomplete (Baru)

Jika Anda menggunakan API yang sudah ada dan ingin bermigrasi ke API baru, lihat panduan migrasi berikut untuk setiap API:

Fitur utama ditambahkan ke Places API (Baru)

Bagian ini membahas fitur utama yang ditambahkan ke Places API (Baru).

Diterapkan di platform standar Google Cloud

Places API (Baru) diimplementasikan pada infrastruktur layanan di Google Cloud. Implementasi ini menghadirkan platform yang lebih aman dan tepercaya dengan opsi keamanan yang ditingkatkan seperti OAuth. Desain API standar ini menghadirkan tingkat konsistensi di seluruh API sehingga meningkatkan efisiensi pengembangan dengan Places API (Baru).

Performa meningkat

Places API (Baru) memberikan performa yang lebih baik, sehingga penggantian aplikasi yang menggunakan Places API yang ada akan bermanfaat.

Penetapan harga yang disederhanakan

Harga disederhanakan dengan Places API (Baru) sehingga Anda hanya membayar untuk data yang Anda gunakan. Harga yang disederhanakan diterapkan menggunakan mask kolom.

Dengan Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru), Anda dapat menggunakan mask kolom untuk mengontrol daftar kolom yang akan ditampilkan dalam respons. Selanjutnya, Anda hanya akan ditagih untuk data yang diminta. Penggunaan penyamaran kolom merupakan praktik desain yang baik untuk memastikan Anda tidak meminta data yang tidak perlu. Cara ini akan membantu Anda menghindari waktu pemrosesan dan biaya penagihan yang tidak perlu.

Data respons yang konsisten untuk suatu tempat

Dengan API yang ada, Place Details, Nearby Search, dan Text Search API menampilkan data respons yang berbeda untuk suatu tempat. Places API (Baru) menstandarkan respons sehingga semua API ini menampilkan data yang sama untuk suatu tempat.

Jenis tempat yang diperluas

Respons API sekarang dapat berisi jenis utama tempat. Setiap tempat dapat memiliki satu jenis nilai yang ditetapkan sebagai jenis utama tempat, seperti yang tercantum dalam Tabel A.

Selain itu, API baru ini menambahkan jenis tempat yang ditampilkan dalam tabel di bawah. Anda dapat menggunakan jenis baru ini, dan jenis yang sudah ada, dalam penelusuran dengan Nearby Search (Baru) dan Text Search (Baru). Semua jenis baru disertakan dalam Tabel A.

Jenis
american_restaurant discount_store ice_cream_shop sandwich_shop
amusement_center dog_park indian_restaurant school_district
athletic_field electric_vehicle_charging_station indonesian_restaurant seafood_restaurant
auto_parts_store event_venue italian_restaurant ski_resort
banquet_hall extended_stay_hotel japanese_restaurant spanish_restaurant
barbecue_restaurant farm korean_restaurant sporting_goods_store
barber_shop Farmstay lebanese_restaurant sports_club
bed_and_breakfast fast_food_restaurant Marina sports_complex
brazilian_restaurant ferry_terminal pasar steak_house
breakfast_restaurant fitness_center medical_lab sushi_restaurant
brunch_restaurant french_restaurant mediterranean_restaurant swimming_pool
bus_stop gift_shop mexican_restaurant penjahit
camping_cabin golf_course middle_eastern_restaurant telecommunications_service_provider
cell_phone_store greek_restaurant motel thai_restaurant
child_care_agency grocery_store national_park transit_depot
chinese_restaurant guest_house park_and_ride truck_stop
coffee_shop hair_salon performing_arts_theater turkish_restaurant
community_center hamburger_restaurant pizza_restaurant vegan_restaurant
konsultan Heliport playground vegetarian_restaurant
convention_center hiking_area prasekolah vietnamese_restaurant
pondok historical_landmark private_guest_room visitor_center
courier_service home_improvement_store ramen_restaurant wedding_venue
cultural_center hostel resort_hotel grosir
dental_clinic hotel rest_stop
Bersama dengan jenis baru ini, Places SDK for Android (Baru) memindahkan jenis berikut dari Tabel B dari Tabel A. Artinya, Anda kini dapat menggunakan jenis ini sebagai bagian dari penelusuran:
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

Data tempat dinamis

Places API (Baru) mendukung data respons dinamis, seperti ketersediaan SPKLU atau harga bahan bakar terbaru untuk SPBU. Gunakan kolom respons ini untuk menciptakan pengalaman pengguna yang dinamis.

API mana yang Anda pilih?

Sebelum dapat memulai pengembangan aplikasi, Anda harus memilih API:

  1. Jika Anda adalah pelanggan baru yang baru mulai menggunakan Places API, mulailah dengan API baru.

  2. Jika Anda adalah pelanggan baru dan belum ada pengganti untuk API yang sudah ada, seperti Place Autocomplete atau Query Autocomplete, Anda dapat menggunakan kombinasi API baru dan yang sudah ada.

  3. Jika Anda adalah pelanggan lama, Anda dapat terus menggunakan API yang sudah ada. Namun, untuk memanfaatkan peningkatan performa dan penyempurnaan fitur Places API (Baru), Anda dapat bermigrasi ke API baru.

    Untuk informasi selengkapnya tentang migrasi, lihat Ringkasan migrasi.