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

Place Add

Anda bisa menggunakan Google Places API for Android untuk menambahkan tempat ke database Google Places. Tempat yang baru ditambahkan tersedia untuk aplikasi Anda dalam waktu yang singkat, dan ditambahkan ke antrean moderasi untuk kemungkinan penambahan ke database Google Places dan Google Maps.

  1. Menambahkan tempat
  2. Menangani beberapa ID tempat dan lingkup ID tempat

Menambahkan tempat

Untuk menambahkan tempat, panggil GeoDataApi.addPlace(), dengan meneruskan objek AddPlaceRequest yang menetapkan detail tempat yang ingin Anda tambahkan.

Sertakan informasi berikut saat membuat AddPlaceRequest:

  • Diperlukan: name tekstual lengkap untuk bisnis, tempat menarik, atau tempat lainnya. Dibatasi hingga 255 karakter.
  • Diperlukan: Objek LatLng yang menetapkan lokasi tempat.
  • Diperlukan: address tempat yang bisa dibaca orang. Jika sebuah tempat memiliki alamat yang diformat dengan baik dan bisa dibaca orang, maka besar kemungkinan akan lulus proses moderasi untuk dimasukkan dalam database Google Places.
  • Diperlukan: Daftar tipe tempat yang mencirikan tempat ini. Untuk daftar tipe tempat yang tersedia, lihat dokumentasi untuk Tipe Tempat dan konstanta yang didefinisikan dalam antarmuka Place.
  • Opsional: phoneNumber tempat tersebut. Ini adalah nomor telepon dalam format internasional. Format internasional menyertakan kode negara dan diawali dengan tanda tambah (+). Misalnya, nomor telepon internasional untuk kantor Google di Mountain View, AS adalah +1 650-253-0000. Jika sebuah tempat memiliki nomor telepon yang diformat dengan baik, maka besar kemungkinan akan lulus proses moderasi untuk dimasukkan dalam database Google Places. Catatan: Anda harus memberikan phoneNumber atau Uri, atau keduanya.
  • Opsional: Sebuah objek Uri berisi alamat situs web resmi untuk tempat ini, seperti laman beranda bisnis. Jika sebuah tempat memiliki alamat situs web yang diformat dengan baik, maka besar kemungkinan akan lulus proses moderasi untuk dimasukkan dalam database Google Places. Catatan: Anda harus memberikan phoneNumber atau Uri, atau keduanya.

API akan mengembalikan PlaceBuffer dalam PendingResult. PlaceBuffer berisi tempat yang telah ditambahkan.

Objek Place hasilnya memiliki ID tempat unik, yang untuk seterusnya bisa digunakan aplikasi Anda untuk mengambil detail tempat. Tempat yang telah ditambahkan juga tersedia setelah beberapa saat dalam hasil permintaan get-current-place yang dibuat oleh aplikasi Anda, dan dalam place-picker yang ditampilkan oleh aplikasi Anda. Lingkup ditentukan oleh ID proyek yang digunakan untuk membuat kunci API Anda.

Tempat yang baru ditambahkan akan memasuki antrean moderasi untuk dipertimbangkan penambahannya ke database Google Places. Tempat yang tidak disetujui oleh proses moderasi akan tetap bisa diambil melalui ID tempat dalam aplikasi yang menyerahkannya, namun tidak akan muncul lagi dalam hasil permintaan get-current-place, api-picker, atau metode API lainnya. Tempat yang lulus moderasi akan bisa dilihat oleh semua aplikasi dan pada Google Maps.

Agar tempat tersebut berpeluang lebih besar lulus dalam proses moderasi dan ditambahkan ke database Google Places, permintaan penambahan harus menyertakan informasi sebanyak mungkin. Khususnya, alamat, nomor telepon dan situs web merupakan hal penting.

Contoh kode berikut menambahkan cagar alam dekat Manly di pantai timur Australia.

AddPlaceRequest place =
    new AddPlaceRequest(
        "Manly Sea Life Sanctuary", // Name
        new LatLng(-33.7991, 151.2813), // Latitude and longitude
        "W Esplanade, Manly NSW 2095", // Address
        Collections.singletonList(Place.TYPE_AQUARIUM), // Place types
        "+61 1800 199 742", // Phone number
        Uri.parse("http://www.manlysealifesanctuary.com.au/") // Website
    );

Places.GeoDataApi.addPlace(mGoogleApiClient, place)
    .setResultCallback(new ResultCallback<PlaceBuffer>() {
        @Override
        public void onResult(PlaceBuffer places) {
            Log.i(TAG, "Place add result: " + places.getStatus().toString());
            Log.i(TAG, "Added place: " + places.get(0).getName().toString());
            places.release();
        }
    });

Menangani beberapa ID tempat dan lingkup ID tempat

Setiap ID tempat bisa merujuk ke satu tempat saja, namun satu tempat bisa memiliki lebih dari satu ID tempat. Kasus yang paling umum untuk menangani multi ID sebuah tempat adalah bila Anda telah menambahkan tempat yang awalnya dalam cakupan aplikasi Anda, lalu menerima cakupan berskala Google.

Bila menambahkan tempat, Anda akan menerima ID tempat untuk tempat baru itu dengan segera. ID tempat ini hanya sebatas untuk aplikasi Anda saja. Tempat tersebut kemudian masuk antrean moderasi, menunggu persetujuan untuk penambahan ke database Google Places. Jika disetujui, tempat itu akan menerima ID tempat baru, yang bisa digunakan semua aplikasi dan pada Google Maps.

Bila Anda meminta sebuah tempat dengan menetapkan ID tempat, Anda bisa yakin akan selalu menerima tempat yang sama dalam respons (jika tempat itu masih ada).

Akan tetapi, perlu diketahui bahwa respons itu mungkin berisi ID tempat yang berbeda dari yang Anda minta. Untuk informasi selengkapnya, lihat ringkasan ID tempat.

Kirim masukan tentang...

location_on
Google Places API for Android