Gaya visual peta berbasis cloud

Google Maps Platform menawarkan fitur Gaya visual peta berbasis Cloud yang memudahkan Anda untuk menata gaya, menyesuaikan, dan mengelola peta menggunakan Konsol Google Cloud, sehingga Anda dapat membuat pengalaman peta yang disesuaikan untuk pengguna tanpa harus memperbarui kode aplikasi setiap kali Anda mengubah gaya.

Gaya yang dibuat sebelum 15 September 2020 tidak akan menampilkan fitur alami yang ditingkatkan pada Google Maps. Guna memanfaatkan dukungan fitur alami yang ditingkatkan pada Google Maps untuk gaya visual peta, Anda harus membuat Gaya peta.

Gaya visual peta berbasis Cloud memungkinkan Anda membuat dan mengedit gaya peta untuk setiap aplikasi yang menggunakan Google Maps, tanpa memerlukan perubahan pada kode setelah ID peta diterapkan. Semua perubahan gaya dapat dilakukan di Konsol Cloud, tanpa memerlukan keahlian coding. Ubah tampilan dan warna berbagai elemen peta seperti jalan, bangunan, perairan, lokasi menarik, dan rute transportasi umum.

Fitur-fitur ini meliputi:

  • Gaya visual peta berbasis Cloud: Daripada menata gaya peta dalam kode menggunakan JSON, Anda dapat mengelola dan menata gaya peta dinamis dan statis di Konsol Cloud menggunakan ID Peta dan gaya peta.
  • Peta Vektor: Developer JavaScript dapat memilih untuk menggunakan peta berbasis vektor yang diakselerasi oleh WebGL yang sama yang tersedia di maps.google.com secara langsung di aplikasi web mereka sendiri.
  • Pemfilteran POI bisnis: Lima kategori lokasi menarik bisnis dapat dihapus dari tampilan peta.
  • Kontrol Kepadatan POI: Kepadatan lokasi menarik yang ditampilkan di peta dasar dapat disesuaikan untuk menampilkan lebih banyak atau lebih sedikit lokasi menarik secara default.

Meskipun Gaya visual peta berbasis Cloud tersedia di Maps SDK for Android1, Maps SDK for iOS, JavaScript, dan Maps Static API, tidak semua fitur dapat dilihat di semua platform.

Sebelum memulai

  • Buat ID peta
    Untuk menggunakan Gaya visual peta berbasis Cloud, peta Anda harus dimuat menggunakan ID peta.
  • Lakukan migrasi dari gaya visual hard code
    Sebelum menambahkan ID peta untuk menggunakan Gaya visual peta berbasis Cloud pada peta yang ada dan disesuaikan dengan gaya visual hard code, seperti parameter kueri URL atau JSON, sebaiknya hapus gaya visual hard code untuk menghindari potensi konflik dengan fungsi pada masa mendatang. Anda dapat mengimpor gaya visual JSON ke gaya peta baru.
* Upgrade Maps SDK for Android
Untuk menggunakan Gaya visual peta berbasis Cloud, Anda harus menggunakan Maps SDK for Android versi 18.0.0 atau yang lebih baru dan menggunakan perender Maps SDK for Android versi terbaru.

Penagihan

Penggunaan Gaya visual peta berbasis Cloud memerlukan ID peta. Di Maps SDK for Android, Maps SDK for iOS, dan JavaScript, menggunakan ID peta akan dikenai biaya atas SKU Dynamic Maps. Di Maps Static API, penggunaan ID peta akan dikenai biaya atas SKU Static Maps.

Contoh

Android

Menjalankan aplikasi contoh ApiDemos

Untuk menjalankan aplikasi contoh ApiDemos, lihat contoh GitHub (Java | Kotlin) dan lihat demo CloudBasedMapStylingDemoActivity (Java | Kotlin).

Anda dapat menemukan contoh aplikasi Java dan Kotlin yang menunjukkan cara menata gaya peta Android dari cloud.

Masalah Umum

Setelah aplikasi diluncurkan kepada pelanggan, gaya kustom untuk peta dengan ID peta dapat diperbarui dari Konsol Google Cloud. Gaya baru akan diterapkan pada aplikasi Anda dalam beberapa jam.

Hapus data aplikasi dari perangkat pengujian Anda guna memastikan gaya kustom baru segera ditampilkan untuk tujuan pengujian. Untuk informasi selengkapnya tentang cara menghapus data dari perangkat, lihat Bantuan Android - Mengosongkan Ruang Penyimpanan.

Perlu diingat bahwa setelan dapat berbeda-beda tergantung ponselnya. Untuk informasi selengkapnya, hubungi produsen perangkat Anda.

iOS

Menjalankan aplikasi contoh ApiDemos

Untuk menjalankan aplikasi contoh ApiDemos, lihat contoh GitHub aplikasi contoh GoogleMap dan lihat project CloudBasedMapStylingViewController (contoh GitHub untuk Swift | Objective-C).

Demo Penataan Gaya Cloud opsional CocoaPod atau GitHub

Daripada memulai dari awal, Anda dapat mencoba aplikasi contoh Objective-C kami yang menunjukkan cara menata gaya peta iOS dari cloud di sini.

Mem-build aplikasi demo Beta

Dalam Xcode, tekan tombol compile untuk membangunnya kemudian jalankan skema saat ini. Build akan menghasilkan error, yang meminta Anda untuk memasukkan kunci API dalam file SDKDemoAPIKey.h.

Jika Anda belum memiliki kunci API, ikuti petunjuk ini untuk menyiapkan project di Konsol Cloud dan mendapatkan kunci API. Saat mengonfigurasi kunci di Konsol Cloud, Anda dapat menentukan ID paket aplikasi untuk memastikan bahwa hanya aplikasi Anda yang dapat menggunakan kunci tersebut. ID paket default aplikasi contoh SDK adalah com.example.GoogleMapsDemos.

Edit file SDKDemoAPIKey.h dan tempelkan kunci API Anda ke dalam definisi konstanta kAPIKey:

```
static NSString *const kAPIKey = @"YOUR_API_KEY";
```

Jika Xcode meminta Anda membuka kunci file SDKDemoAPIKey.h untuk diedit, pilih Buka kunci.

Hapus baris berikut:

```
#error Register for API Key and insert here.
```

Bangun dan jalankan proyek.

Demo peta gaya visual peta berbasis Cloud

Demo CloudStyling menunjukkan cara menata gaya peta menggunakan gaya yang ditetapkan di Konsol Google Cloud.

Saat aplikasi demo diluncurkan, klik demo Penyesuaian Peta di bagian Contoh Beta di bagian atas daftar.

Klik Peta Gaya untuk melihat efek pemuatan ID Peta yang berbeda.

Anda juga dapat mencoba menambahkan gaya Anda sendiri ("Peta Gaya" > "Tambahkan ID Peta baru"), dan lihat pembaruan peta dengan peta bergaya kustom Anda.

JavaScript

Contoh ini adalah contoh dasar dari pemuatan peta bergaya kustom menggunakan ID peta. Dalam hal ini, Maps JavaScript mereferensikan ID peta 8e0a97af9386fef saat peta dimuat, dan otomatis menerapkan gaya peta yang saat ini terkait dengan ID peta tersebut.

TypeScript

function initMap(): void {
  new google.maps.Map(
    document.getElementById("map") as HTMLElement,
    {
      mapId: "8e0a97af9386fef",
      center: { lat: 48.85, lng: 2.35 },
      zoom: 12,
    } as google.maps.MapOptions
  );
}

declare global {
  interface Window {
    initMap: () => void;
  }
}
window.initMap = initMap;

JavaScript

function initMap() {
  new google.maps.Map(document.getElementById("map"), {
    mapId: "8e0a97af9386fef",
    center: { lat: 48.85, lng: 2.35 },
    zoom: 12,
  });
}

window.initMap = initMap;
Lihat contoh

Mencoba Contoh

Maps Static API

ID peta adalah ID yang dikaitkan dengan gaya atau fitur peta tertentu. Konfigurasikan gaya peta dan kaitkan dengan ID peta di Google Cloud Console. Selanjutnya, saat Anda mereferensikan ID peta dalam kode, gaya peta yang terkait akan ditampilkan di aplikasi Anda. Setiap perubahan gaya yang selanjutnya Anda buat akan otomatis ditampilkan di aplikasi, tanpa perlu update dari pelanggan.

  1. Jika Anda menggunakan Gaya visual peta berbasis Cloud dengan peta yang sudah ada dan disesuaikan dengan parameter style, pastikan untuk menghapusnya guna menghindari potensi konflik dengan fungsi di masa mendatang.

  2. Untuk menambahkan ID peta ke peta baru atau yang sudah ada yang menggunakan salah satu API web kami, tambahkan parameter URL map_id dan tetapkan ke ID peta Anda. Contoh ini menunjukkan penambahan ID peta ke peta menggunakan Maps Static API.

    <img src="https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY&map_id=YOUR_MAP_ID&signature=YOUR_SIGNATURE" />
    


  1. Gaya visual peta berbasis Cloud tidak tersedia di Mode Ringan Android