Memulai

Panduan ini adalah cara mulai cepat untuk membuat aplikasi Android yang menampilkan peta. Android Studio adalah lingkungan pengembangan yang direkomendasikan untuk membuat aplikasi dengan Maps SDK for Android.

Langkah 1. Download Android Studio

Ikuti panduan untuk mendownload dan menginstal Android Studio.

Langkah 2. Instal SDK layanan Google Play

Tambahkan layanan Google Play ke Android Studio.

Langkah 3. Buat project Google Maps

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

  1. Mulai Android Studio.
  2. Buat project baru sebagai berikut:
    • Jika Anda melihat dialog Welcome to Android Studio, pilih Start a new Android Studio project, yang ada di bagian 'Quick Start', di sebelah kanan dialog.
    • Jika tidak, klik File di panel menu Android Studio, lalu New, New Project.
  3. Pada dialog Choose your project, pilih tab yang sesuai dengan platform yang ingin Anda kembangkan. Sebagian besar pengguna ingin mempertahankan Phone and Tablet secara default.
  4. Pilih Google Maps Activity, lalu klik Next.
  5. Masukkan nama aplikasi, nama paket, dan lokasi project, bahasa pemrograman (Java atau Kotlin), dan level minimum Android API yang didukung oleh aplikasi Anda, lalu klik Finish.

Android Studio memulai Gradle dan membuat project Anda. Proses ini mungkin perlu waktu beberapa detik Untuk informasi selengkapnya tentang cara membuat project di Android Studio, lihat [dokumentasi Android Studio][studio-project].

Setelah selesai dibuat, Android Studio akan membuka file google_maps_api.xml dan MapsActivity.java di editor. (Perhatikan bahwa aktivitas Anda mungkin memiliki nama berbeda, namun itulah yang akan digunakan dalam konfigurasi selama penyiapan.) Perhatikan bahwa file google_maps_api.xml berisi petunjuk tentang cara mendapatkan kunci Google Maps API sebelum Anda mencoba menjalankan aplikasi. Bagian selanjutnya menjelaskan cara mendapatkan kunci API secara lebih detail.

Langkah 4. Siapkan kunci Google Maps API

  1. Aktifkan penagihan di project Anda. Untuk detailnya, lihat membuat akun penagihan.
  2. Di Cloud Console, aktifkan Maps SDK for Android di project Anda. Untuk mengetahui detailnya, lihat mengaktifkan API.
  3. Ikuti panduan Mendapatkan Kunci API untuk mendapatkan, menambahkan, dan membatasi kunci API.

Langkah 5. Lihat kodenya

Periksa kode yang disediakan oleh template. Secara khusus, lihat file berikut di project Android Studio Anda.

File tata letak XML

Secara default, file XML yang menentukan tata letak aplikasi ada 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 menentukan aktivitas peta diberi nama MapsActivity.java. Kode berikut harus disertakan setelah nama paket Anda:

Java

// Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package com.google.maps.example;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

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 AppCompatActivity implements OnMapReadyCallback {

    private GoogleMap mMap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_maps);
        // Obtain the SupportMapFragment and get notified when the map is ready to be used.
        SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
                .findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    /**
     * Manipulates the map once available.
     * This callback is triggered when the map is ready to be used.
     * This is where we can add markers or lines, add listeners or move the camera. In this case,
     * we just add a marker near Sydney, Australia.
     *
     * If Google Play services is not installed on the device, the user will be prompted to install
     * it inside the SupportMapFragment. This method will only be triggered once the user has
     * installed Google Play services and returned to the app.
     */
    @Override
    public void onMapReady(GoogleMap googleMap) {
        mMap = googleMap;

        // Add a marker in Sydney 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));
    }
}

      

Kotlin

// Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package com.google.maps.example.kotlin

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle

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
import com.google.maps.example.R

internal class MapsActivity : AppCompatActivity(), OnMapReadyCallback {

    private lateinit var mMap: GoogleMap

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_maps)
        // Obtain the SupportMapFragment and get notified when the map is ready to be used.
        val mapFragment = supportFragmentManager
            .findFragmentById(R.id.map) as SupportMapFragment
        mapFragment.getMapAsync(this)
    }

    /**
     * Manipulates the map once available.
     * This callback is triggered when the map is ready to be used.
     * This is where we can add markers or lines, add listeners or move the camera. In this case,
     * we just add a marker near Sydney, Australia.
     * If Google Play services is not installed on the device, the user will be prompted to install
     * it inside the SupportMapFragment. This method will only be triggered once the user has
     * installed Google Play services and returned to the app.
     */
    override fun onMapReady(googleMap: GoogleMap) {
        mMap = googleMap

        // Add a marker in Sydney and move the camera
        val sydney = LatLng(-34.0, 151.0)
        mMap.addMarker(MarkerOptions()
            .position(sydney)
            .title("Marker in Sydney"))
        mMap.moveCamera(CameraUpdateFactory.newLatLng(sydney))
    }
}
      

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

Langkah 6. Hubungkan perangkat Android

Cara termudah untuk melihat cara kerja aplikasi Anda adalah dengan menghubungkan perangkat Android ke komputer. Ikuti petunjuk untuk mengaktifkan opsi developer di perangkat Android Anda dan mengonfigurasikan aplikasi dan sistem untuk mendeteksi perangkat tersebut.

Atau, Anda dapat menggunakan Android Emulator untuk menjalankan aplikasi. Gunakan Manajer Perangkat Virtual Android (AVD) untuk mengonfigurasi satu atau beberapa perangkat virtual yang dapat digunakan dengan Android Emulator saat Anda membuat dan menjalankan aplikasi. Saat memilih emulator, pastikan Anda menggunakan Android 4.1.1 atau versi yang lebih tinggi, dan pilih dengan cermat gambar yang menyertakan Google API, atau aplikasi tidak akan memiliki API runtime yang diperlukan untuk eksekusi. Selain itu, perhatikan petunjuk untuk mengonfigurasi akselerasi mesin virtual, yang harus Anda gunakan dengan x86 target AVD seperti yang dijelaskan dalam petunjuk. Tindakan ini akan meningkatkan kualitas pengalaman Anda dengan emulator.

Langkah 7. Deploy dan jalankan aplikasi

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

Jika diminta memilih perangkat, pilih salah satu opsi berikut:

  • Pilih perangkat Android yang terhubung ke komputer Anda.
  • Atau, pilih tombol pilihan Launch emulator dan pilih perangkat virtual yang telah Anda konfigurasikan sebelumnya.

Klik OK. Android Studio akan memanggil Gradle untuk membuat aplikasi Anda, lalu menampilkan hasilnya di perangkat atau emulator. Perlu waktu beberapa menit sebelum aplikasi terbuka.

Langkah berikutnya

Anda mungkin perlu melihat kode contoh tertentu.

Anda dapat membaca selengkapnya tentang objek peta di panduan developer.