Bermigrasi ke Klien GoogleApi

Rilis 11.2.0 SDK layanan Google Play menyertakan cara baru untuk mengakses Places SDK for Android. Klien GoogleApi lebih mudah digunakan daripada pendahulunya (GoogleApiClient), karena klien ini otomatis mengelola koneksi ke layanan Google Play. Hal ini mengurangi jumlah kode boilerplate di aplikasi Anda, dan dapat membantu menghilangkan banyak masalah umum. API baru menawarkan sejumlah peningkatan:

• Proses koneksi dikelola secara otomatis, sehingga API baru lebih mudah diimplementasikan.
• Panggilan API kini otomatis menunggu koneksi layanan dibuat, sehingga Anda tidak perlu menunggu onConnected sebelum membuat permintaan.
• Tasks API memudahkan pembuatan operasi asinkron.
• Kode ini bersifat mandiri, dan dapat dipindahkan ke class utilitas umum atau yang serupa.

Mengupdate aplikasi untuk menggunakan klien GoogleApi memerlukan beberapa perubahan pada implementasi Places SDK for Android. Panduan ini menjelaskan perubahan pada Places SDK untuk Android, dan merekomendasikan langkah-langkah yang harus dilakukan saat mengupdate aplikasi untuk menggunakan klien baru.

Ringkasan

Area perubahan utamanya adalah sebagai berikut:

• Ada dua titik entri baru: GeoDataClient dan PlaceDetectionClient. Daripada membuat satu instance GoogleApiClient untuk mencakup semua API, aplikasi Anda sekarang harus membuat instance GeoDataClient dan PlaceDetectionClient.
• Karena callback koneksi tidak lagi diperlukan, Anda dapat memfaktorkan ulang aplikasi dengan aman untuk menghapusnya.
• Metode Places API baru kini bersifat asinkron, dan menampilkan Task, bukan PendingResult.

Memuat Places API

Untuk memuat Places API, deklarasikan titik entri, lalu buat instance klien dalam metode onCreate() fragmen atau aktivitas Anda seperti yang ditunjukkan dalam contoh berikut:

// The entry points to the Places API.
private GeoDataClient mGeoDataClient;
private PlaceDetectionClient mPlaceDetectionClient;

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

    // Construct a GeoDataClient.
    mGeoDataClient = Places.getGeoDataClient(this, null);

    // Construct a PlaceDetectionClient.
    mPlaceDetectionClient = Places.getPlaceDetectionClient(this, null);

Perbandingan

Metode Places API baru kini bersifat asinkron, dan menampilkan Task, bukan PendingResult. Struktur data belum berubah, sehingga kode yang ada untuk menangani hasil tidak perlu diperbarui. Contoh kode berikut membandingkan versi baru dan sebelumnya GetCurrentPlace():

Cara baru

Task<PlaceLikelihoodBufferResponse> placeResult = mPlaceDetectionClient.getCurrentPlace(null);
placeResult.addOnCompleteListener(new OnCompleteListener<PlaceLikelihoodBufferResponse>() {
    @Override
    public void onComplete(@NonNull Task<PlaceLikelihoodBufferResponse> task) {
        PlaceLikelihoodBufferResponse likelyPlaces = task.getResult();
        for (PlaceLikelihood placeLikelihood : likelyPlaces) {
            Log.i(TAG, String.format("Place '%s' has likelihood: %g",
                placeLikelihood.getPlace().getName(),
                placeLikelihood.getLikelihood()));
        }
        likelyPlaces.release();
    }
});

Cara lama

PendingResult<PlaceLikelihoodBuffer> result = Places.PlaceDetectionApi
    .getCurrentPlace(mGoogleApiClient, null);
result.setResultCallback(new ResultCallback<PlaceLikelihoodBuffer>() {
  @Override
  public void onResult(PlaceLikelihoodBuffer likelyPlaces) {
    for (PlaceLikelihood placeLikelihood : likelyPlaces) {
      Log.i(TAG, String.format("Place '%s' has likelihood: %g",
          placeLikelihood.getPlace().getName(),
          placeLikelihood.getLikelihood()));
    }
    likelyPlaces.release();
  }
});

Pelajari lebih lanjut

Pelajari lebih lanjut cara mengakses Google API.