Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Maps Android API

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 Maps Android API
  3. Buat kunci yang sesuai
Lanjutkan

Memulai

Panduan ini merupakan langkah cepat untuk memulai penambahan peta ke aplikasi Android. Android Studio adalah lingkungan development. yang disarankan untuk membangun aplikasi dengan Google Maps Android API.

Langkah 1. Unduh Android Studio

Ikuti panduan untuk mengunduh dan memasang Android Studio.

Langkah 2. Pasang Google Play services SDK

Tambahkan paket Google Play Services ke Android Studio.

Langkah 3. Buat proyek Google Maps

Ikuti langkah-langkah ini untuk membuat proyek aplikasi baru termasuk aktivitas peta:

  1. Mulailah Android Studio.
  2. Buat proyek baru sebagai berikut:

    • Jika Anda melihat dialog Welcome to Android Studio, pilih Start a new Android Studio project, yang ada di bawah 'Quick Start', di sebelah kanan dialog tersebut.
    • Atau, klik File di baris menu Android Studio, kemudian New, New Project.
  3. Masukkan nama aplikasi Anda, domain perusahaan, lokasi proyek, saat diminta. Kemudian klik Next.

  4. Pilih faktor-bentuk yang diperlukan untuk aplikasi Anda. Jika tidak tahu apa yang Anda perlukan, pilih saja Phone and Tablet. Kemudian klik Next.
  5. Pilih Google Maps Activity dalam dialog 'Add an activity to Mobile'. Kemudian klik Next.
  6. Masukkan nama aktivitas, nama layout dan judul saat diminta. Anda boleh menggunakan nilai default. Kemudian klik Finish.

Android Studio akan membuat Gradle dan membangun proyek Anda. Ini mungkin perlu waktu beberapa detik. Untuk informasi selengkapnya tentang membuat proyek dalam Android Studio, lihat dokumentasi Android Studio.

Setelah pembangunan selesai, Android Studio akan membuka file google_maps_api.xml dan file MapsActivity.java dalam editor. (Perhatikan bahwa aktivitas Anda mungkin memiliki nama yang berbeda, namun aktivitas itu adalah yang akan dikonfigurasi selama setup.) Perhatikan bahwa file google_maps_api.xml berisi petunjuk tentang mendapatkan kunci Google Maps API sebelum Anda mencoba menjalankan aplikasi. Bagian berikutnya menjelaskan cara mendapatkan kunci API secara lebih detail.

Langkah 4. Mendapatkan kunci Google Maps API

Aplikasi Anda memerlukan kunci API untuk mengakses server Google Maps. Tipe kunci yang Anda butuhkan adalah kunci API dengan pembatasan untuk aplikasi Android. Kunci ini gratis. Anda bisa menggunakannya bersama aplikasi apa saja yang memanggil Google Maps Android API, dan kunci ini mendukung jumlah pengguna yang tidak terbatas.



Pilih salah satu dari cara berikut untuk mendapatkan kunci API Anda dari Android Studio:

  • Cara yang cepat dan mudah: Gunakan tautan yang disediakan dalam file google_maps_api.xml yang dibuat Android Studio untuk Anda:
    1. Salin tautan yang disediakan dalam file google_maps_api.xml dan tempelkan ke dalam browser Anda. Tautan ini akan membawa Anda ke Google API Console dan memberikan informasi yang diperlukan ke Google API Console melalui parameter URL, sehingga mengurangi masukan manual yang diperlukan dari Anda.
    2. Ikuti petunjuk untuk membuat proyek baru pada Google API Console atau pilih proyek yang sudah ada.
    3. Buat kunci API yang terbatas-Android untuk proyek Anda.
    4. Salin kunci API yang dihasilkan, kembali ke Android Studio, dan tempelkan kunci API ke dalam elemen <string> dalam file google_maps_api.xml.
  • Cara yang kurang cepat: Gunakan kredensial yang disediakan dalam file google_maps_api.xml yang dibuat Android Studio untuk Anda:
    1. Salin kredensial yang disediakan dalam file google_maps_api.xml.
    2. Masuklah ke Google API Console dalam browser Anda.
    3. Gunakan kredensial yang telah disalin untuk menambahkan aplikasi Anda ke kunci API yang sudah ada atau untuk membuat kunci API baru.
  • Proses lengkap untuk mendapatkan kunci API: Jika tidak satu pun opsi di atas yang cocok untuk situasi Anda, ikuti proses lengkap.

Langkah 5. Halo Peta! Lihat kode ini

Periksa kode yang disediakan oleh template. Khususnya, lihat file berikut dalam proyek Android Studio Anda.

File layout XML

Secara default, file XML yang mendefinisikan layout aplikasi berada di res/layout/activity_maps.xml. File ini berisi kode berikut:

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:id="@+id/map"
    tools:context=".MapsActivity"
    android:name="com.google.android.gms.maps.SupportMapFragment" />

File Java aktivitas peta

Secara default, file Java yang mendefinisikan aktivitas peta bernama MapsActivity.java. File ini harus berisi kode berikut setelah nama paket Anda:

import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
import com.google.android.gms.maps.CameraUpdateFactory;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.MarkerOptions;

public class MapsActivity extends FragmentActivity implements OnMapReadyCallback {

    private GoogleMap mMap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_maps);
        SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
                .findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    @Override
    public void onMapReady(GoogleMap googleMap) {
        mMap = googleMap;

        // Add a marker in Sydney, Australia, and move the camera.
        LatLng sydney = new LatLng(-34, 151);
        mMap.addMarker(new MarkerOptions().position(sydney).title("Marker in Sydney"));
        mMap.moveCamera(CameraUpdateFactory.newLatLng(sydney));
    }
}

Jika file aktivitas peta Anda tidak berisi kode di atas, ganti materi file dengan kode di atas, setelah nama paket Anda.

Langkah 6. Hubungkan perangkat Android

Cara paling sederhana untuk melihat aplikasi Anda beraksi adalah dengan menghubungkan perangkat Android ke komputer Anda. Ikuti petunjuk untuk mengaktifkan opsi developer pada perangkat Android Anda serta mengonfigurasi aplikasi dan sistem Anda untuk mendeteksi perangkat.

Atau, Anda bisa menggunakan Android Emulator untuk menjalankan aplikasi Anda. Gunakan Android Virtual Device (AVD) Manager untuk mengonfigurasi satu atau beberapa perangkat maya yang Anda inginkan untuk digunakan bersama Android Emulator saat mengembangkan dan menjalankan aplikasi Anda. Ketika memilih emulator, pastikan bahwa Anda menggunakan Android 4.2.2 atau yang lebih tinggi, dan berhati-hatilah untuk memilih gambar yang memuat Google API, atau aplikasi tidak akan memiliki API runtime yang diperlukan untuk menjalankannya. Juga, catatlah petunjuk untuk mengonfigurasi akselerasi mesin maya, yang harus Anda gunakan dengan x86 target AVD seperti dijelaskan dalam petunjuk. Ini akan meningkatkan pengalaman Anda pada emulator.

Langkah 7. Bangun dan jalankan aplikasi Anda

Dalam Android Studio, klik opsi menu Run (atau ikon tombol play) untuk menjalankan aplikasi Anda.

Bila diminta memilih perangkat, pilih salah satu opsi berikut:

  • Pilih perangkat Android yang terhubung ke komputer Anda.
  • Atau, pilih tombol radio Launch emulator dan pilih perangkat maya yang telah Anda konfigurasi sebelumnya.

Klik OK. Android Studio akan memanggil Gradle untuk membangun aplikasi Anda, kemudian menampilkan hasilnya pada perangkat atau pada emulator. Perlu waktu beberapa menit sebelum aplikasi dibuka.

Anda harus melihat peta dengan marker yang ditempatkan di atas Sydney, Australia. Jika tidak melihat peta, pastikan Anda telah melakukan semua langkah yang dijelaskan pada laman ini. Khususnya, periksa apakah Anda telah menambahkan kunci API seperti dijelaskan di atas.

Langkah berikutnya

Anda mungkin perlu melihat beberapa kode contoh.

Anda bisa membaca selengkapnya tentang objek peta dalam panduan developer.

Kirim masukan tentang...

Google Maps Android API
Google Maps Android API
Butuh bantuan? Kunjungi halaman dukungan kami.