Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Places API for Android

Untuk membantu Anda memulai, kami akan memandu Anda melalui Google Developers Console untuk melakukan beberapa hal terlebih dahulu:

  1. Buat atau pilih sebuah proyek
  2. Aktifkan Google Places API for Android
  3. Buat kunci yang sesuai
Lanjutkan

Memulai

Panduan ini memperkenalkan fitur-fitur dalam Google Places API for Android dan menampilkan cara mengonfigurasi aplikasi Anda untuk menggunakan API.

  1. Pengantar dan konsep
  2. Ringkasan API
  3. Versi platform Android yang didukung
  4. Mengonfigurasi aplikasi Anda
    1. Mempersiapkan Google Play Services
    2. Menambahkan kunci API Anda
    3. Meminta peningkatan batas penggunaan
  5. Menghubungkan ke Places API

Pengantar dan konsep

Titik masuk utama untuk Google Places API for Android adalah widget UI PlacePicker, widget UI Autocomplete, GeoDataApi, dan PlaceDetectionApi.

Dengan menggunakan Google Places API for Android, Anda bisa membuat aplikasi sesuai-lokasi yang merespons secara kontekstual terhadap tempat bisnis setempat dan tempat lain yang ada di dekat perangkat. Ini berarti Anda bisa membuat aplikasi kaya fitur berdasarkan tempat-tempat yang memiliki arti bagi pengguna, untuk melengkapi layanan geografis yang ditawarkan oleh layanan lokasi Android.

Tempat didefinisikan sebagai ruang fisik yang memiliki nama. Cara lain untuk membayangkan suatu tempat adalah apa saja yang bisa Anda temukan pada peta. Contohnya antara lain bisnis setempat, tempat menarik, dan lokasi geografis. Dalam API, sebuah tempat dinyatakan melalui antarmuka Place. Hal ini termasuk informasi seperti nama tempat dan alamatnya, lokasi geografis, ID tempat, nomor ponsel, tipe tempat, URL situs web, dan lainnya.

Ringkasan API

Bantu pelanggan Anda mengetahui lokasi mereka dan apa yang ada di sekitar mereka:

  • Gunakan widget UI place-picker bawaan, yang memungkinkan pengguna memilih tempat pada peta interaktif.
  • Dapatkan tempat sekarang, yaitu tempat perangkat terakhir diketahui berada. API mengembalikan daftar tempat yang mungkin dan indikasi kemungkinan relatif untuk setiap tempat.
  • Mudahkan memasukkan nama tempat dan alamat - melengkapi otomatis kueri pengguna Anda saat mereka mengetik. Gunakan widget UI Autocomplete, atau panggil API untuk prediksi tempat.
  • Ambil dan tampilkan secara lengkap [informasi tentang tempat].
  • Akses foto tempat berkualitas tinggi.

Bedakan aplikasi Anda dengan menyediakan informasi lokal terkini:

  • Tambahkan tempat ke database Google Places, untuk pengambilan segera dari dalam aplikasi Anda sendiri dan untuk visibilitas ke aplikasi lain setelah moderasi.
  • Melaporkan tempat, untuk menunjukkan bahwa perangkat saat ini berada di tempat tertentu.
  • Simpan place ID unik untuk satu atau beberapa tempat, dan gunakan ID untuk mengambil informasi tempat bila ada permintaan.

Fitur unggulan lainnya pada API antara lain:

  • Deteksi tempat akurat yang rendah daya dengan pemindaian WiFi.
  • Caching di-perangkat: Sebagian besar permintaan ke Google Places API for Android mungkin melibatkan perjalanan bolak-balik ke server Google, namun Anda juga bisa menyimpan sementara data itu secara lokal selama 30 hari.

Versi platform Android yang didukung

Google Places API for Android tersedia untuk semua versi Android yang didukung oleh Google Play Services. Lihat panduan Android untuk mendukung versi platform berbeda.

Mengonfigurasi aplikasi Anda

Langkah-langkah konfigurasi berikut diperlukan untuk semua aplikasi yang menggunakan Google Places API for Android.

Mempersiapkan Google Play Services

Untuk mengakses Google Places API for Android, proyek development aplikasi Anda harus menyertakan Google Play Services. Unduh dan pasang komponen Google Play Services melalui SDK Manager dan tambahkan pustaka ke proyek Anda. Untuk detailnya, lihat panduan Android untuk menyiapkan Google Play Services.

Menambahkan kunci API Anda

Jika Anda belum memperoleh kunci API dan mengaktifkan Google Places API for Android, ikuti petunjuk dalam panduan pendaftaran untuk mendapatkannya sekarang.

Tambahkan kunci API Anda ke manifes aplikasi seperti yang ditampilkan dalam contoh kode berikut, dengan mengganti YOUR_API_KEY dengan kunci API Anda sendiri:

<application>
  ...
  <meta-data
      android:name="com.google.android.geo.API_KEY"
      android:value="YOUR_API_KEY"/>
</application>

Meminta peningkatan batas penggunaan

Penggunaan Google Places API for Android gratis dan tidak terbatas untuk semua aplikasi. Akan tetapi, untuk memastikan penggunaan wajar oleh semua aplikasi, ada batas kueri bertingkat pada beberapa metode.

Google Places API for Android memberlakukan batas default sebesar 1,000 permintaan per jangka waktu 24 jam. Jika aplikasi Anda melebihi batas, aplikasi akan gagal untuk dimulai.

Ada titik pemeriksaan lebih jauh saat aplikasi mencapai 150,000 permintaan per jangka waktu 24 jam. Jika aplikasi Anda melebihi batas, aplikasi akan gagal lagi untuk dimulai.

Lakukan langkah-langkah untuk menambah batas dari awal jika Anda memperkirakan akan melebihi jumlah permintaan default yang diperbolehkan. Lihat panduan batas penggunaan.

Menghubungkan ke Places API

Antarmuka berikut menyediakan titik masuk utama ke Google Places API for Android:

  • GeoDataApi menyediakan akses ke database tempat lokal dan informasi bisnis milik Google.
  • PlaceDetectionApi menyediakan akses cepat ke tempat perangkat saat ini, dan menawarkan kesempatan untuk melaporkan lokasi perangkat pada tempat tertentu.

Untuk menghubungkan ke API, Anda perlu membuat instance klien Google Play Services API. Dalam metode onCreate() fragmen atau aktivitas Anda, buatlah instance Google API Client menggunakan GoogleApiClient.Builder. Gunakan builder untuk menambahkan API yang diperlukan, seperti yang ditampilkan dalam contoh kode berikut:

import com.google.android.gms.common.api.GoogleApiClient;
import com.google.android.gms.common.api.GoogleApiClient.OnConnectionFailedListener;
import android.support.v4.app.FragmentActivity;

public class MyActivity extends FragmentActivity 
        implements OnConnectionFailedListener {
    private GoogleApiClient mGoogleApiClient;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mGoogleApiClient = new GoogleApiClient
                .Builder(this)
                .addApi(Places.GEO_DATA_API)
                .addApi(Places.PLACE_DETECTION_API)
                .enableAutoManage(this, this)
                .build();
    }

    // TODO: Please implement GoogleApiClient.OnConnectionFailedListener to
    // handle connection failures.
}

Seperti yang ditampilkan dalam contoh kode, kelas Places menyediakan token yang bisa Anda teruskan ke GoogleApiClient.Builder untuk mengaktifkan GeoDataApi dan PlaceDetectionApi.

Untuk detail tentang menggunakan klien, lihat panduan Android untuk Mengakses Google API. Khususnya, lihat panduan untuk memulai koneksi dan menangani kegagalan koneksi, untuk informasi selengkapnya tentang addConnectionCallbacks() dan addOnConnectionFailedListener().

Kirim masukan tentang...

location_on
Google Places API for Android