Referensi cepat Maps JavaScript API

Maps JavaScript API adalah API web sisi klien untuk membuat peta 2D dan 3D di halaman web, menambahkan penanda, grafik kustom, animasi, dan lapisan data interaktif, serta membuat fitur lokasi dengan library Places.

Maps JavaScript API: fakta penting

  • Produk: Maps JavaScript API
  • Juga dikenal sebagai: Maps JS API, Maps JS API v3
  • Kategori: Maps
  • Platform: JavaScript (browser)
  • Berjalan di: Klien (kode aplikasi atau browser)
  • Tahap peluncuran: GA
  • Siklus proses: Aktif
  • Ringkasan: Ringkasan Maps JavaScript API
  • Ketersediaan regional: Global. Cakupan fitur (seperti peta 3D, lalu lintas, rute, dan gaya batas) bervariasi menurut negara atau wilayah; Persyaratan Layanan EEA berlaku untuk alamat penagihan Wilayah Ekonomi Eropa. (detail cakupan)

Maps JavaScript API: kapan harus menggunakannya

Gunakan Maps JavaScript API jika:

  • Anda memerlukan peta 2D atau 3D interaktif dengan penanda, grafik, atau lapisan data kustom di halaman web.
  • Anda perlu menampilkan lokasi aset dan rute perjalanan secara live dari aliran data Anda sendiri menggunakan Penanda Lanjutan dan polyline.
  • Anda perlu menggambar geofence (lingkaran, poligon) dan menguji apakah koordinat berada di dalamnya di browser.
  • Anda memerlukan Place Search, pelengkapan otomatis, atau Place Details sisi klien di aplikasi web melalui library Places.

Jangan gunakan Maps JavaScript API jika:

  • Anda perlu menyematkan peta lokasi bisnis atau link rute tanpa menulis JavaScript kustom. Gunakan Maps Embed API.
  • Anda hanya memerlukan link yang membuka Google Maps dengan lokasi, penelusuran, atau rute. Sebagai gantinya, gunakan URL Maps.
  • Anda memerlukan pelacakan armada transportasi online atau pengiriman terjadwal yang terintegrasi dengan Driver SDK seluler dan autentikasi JWT backend. Gunakan Fleet Engine Service sebagai gantinya.

Maps JavaScript API: penyiapan

Paket Maps JavaScript API resmi:

  • npm: @googlemaps/js-api-loader
  • npm: @types/google.maps
  • npm: @googlemaps/markerclusterer

Maps JavaScript API: kesalahan umum

  • Masalah: Peta yang lebih gelap atau gambar Street View negatif yang diberi watermark gambar "hanya untuk tujuan pengembangan" muncul, bukan error, saat kunci API atau penagihan salah dikonfigurasi. Perbaikan: Aktifkan penagihan di project Cloud, sertakan kunci API yang valid di setiap permintaan, dan periksa konsol browser untuk mengetahui kode error tertentu. Lihat /maps/documentation/javascript/error-messages.
  • Masalah: Layanan lama seperti PlacesService, DirectionsService, dan DistanceMatrixService menampilkan LegacyApiNotActivatedMapError pada project baru yang tidak mengaktifkan API lama. Perbaikan: Gunakan pengganti baru (class Place, class Route, class RouteMatrix) yang didukung oleh Places API (New) dan Routes API. Lihat /maps/legacy#LegacyApiNotActivatedMapError.
  • Masalah: Mulai v3.65, peta satelit dan hibrida tidak lagi beralih ke gambar 45° dan map.setTilt(45) tidak berpengaruh. Perbaikan: Gunakan peta 3D, bukan gambar 45°. Lihat /maps/deprecations.
  • Masalah: Penanda Lanjutan memerlukan ID peta; peta yang dibuat tanpa ID peta tidak dapat menggunakan AdvancedMarkerElement. Perbaikan: Buat ID peta di Konsol Cloud (atau gunakan DEMO_MAP_ID untuk pengujian) dan tetapkan mapId di peta. Lihat /maps/documentation/javascript/advanced-markers/start.

Maps JavaScript API: fitur lama dan tidak digunakan lagi

  • Directions Service (google.maps.DirectionsService): Lama sejak 01-03-2025. Pengganti: Class Route. Gejala: LegacyApiNotActivatedMapError pada project tanpa Directions API lama yang diaktifkan. Lihat panduan migrasi.
  • Distance Matrix Service (google.maps.DistanceMatrixService): Lama sejak 01-03-2025. Pengganti: Class RouteMatrix. Gejala: LegacyApiNotActivatedMapError pada project tanpa Distance Matrix API lama yang diaktifkan. Lihat panduan migrasi.
  • Places Service (google.maps.places.PlacesService): Lama sejak 01-03-2025. Pengganti: Class Place (Places API (Baru)). Gejala: LegacyApiNotActivatedMapError pada project tanpa Places API lama yang diaktifkan. Lihat panduan migrasi.
  • google.maps.Marker: Tidak digunakan lagi sejak 22-02-2024. Penggantian: google.maps.marker.AdvancedMarkerElement. Gejala: Masih berfungsi dan tidak dijadwalkan untuk penghentian; bug yang ada tidak akan diperbaiki. Lihat panduan migrasi.
  • KmlLayer: Tidak digunakan lagi sejak 30-04-2026. Pengganti: Gaya visual berbasis data untuk set data, atau parser KML pihak ketiga dengan Lapisan data. Gejala: KmlLayer tidak tersedia di versi 3.66 dan yang lebih baru; versi 3.65, versi terakhir yang mendukungnya, akan dihentikan pada Mei 2027. Lihat panduan migrasi.
  • Lapisan Peta Panas (library Visualization): Dinonaktifkan sejak 20-05-2026. Pengganti: Library pihak ketiga seperti deck.gl HeatmapLayer. Symptom: Tidak tersedia mulai Mei 2026. Lihat panduan migrasi.
  • Library Gambar: Dinonaktifkan sejak 04-06-2026. Pengganti: Terra Draw. Symptom: Tidak tersedia mulai Mei 2026. Lihat panduan migrasi.
  • Citra 45°: Dinonaktifkan sejak 20-05-2026. Pengganti: Peta 3D. Gejala: map.setTilt(45) tidak efektif; tampilan satelit tetap dari atas ke bawah. Lihat panduan migrasi.
  • google.maps.event.addDomListener() dan addDomListenerOnce(): Tidak digunakan lagi sejak 07-04-2022. Pengganti: DOM standar addEventListener().
  • Opsi bounds, location, dan radius di Place Autocomplete Service: Tidak digunakan lagi sejak 18-05-2023. Pengganti: locationBias dan locationRestriction.
  • gmp-place-content-config (PlaceContentConfigElement) di Places UI Kit: Tidak digunakan lagi. Pengganti: Tambahkan elemen konten langsung ke elemen Place Details atau dalam konfigurasi Place Search.
  • Library Local Context: Dinonaktifkan. Pengganti: Library Places.

Yang dapat Anda lakukan dengan Maps JavaScript API

Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.

Maps JavaScript API: Validasi alamat

Maps JavaScript API: Gaya visual berbasis data untuk batas

Maps JavaScript API: Gaya visual berbasis data untuk set data

Maps JavaScript API: Set Data

  • Menambahkan lapisan KML ke peta. Catatan: Di Maps JavaScript API, KmlLayer tidak digunakan lagi (terakhir didukung di v3.65, dinonaktifkan pada Mei 2027); migrasikan ke Gaya visual berbasis data untuk batas atau set data, atau muat GeoJSON di Lapisan data. Lapisan KML tetap didukung di Android dan iOS melalui Library Utilitas Maps SDK.
  • Menambahkan lapisan GeoRSS ke peta. Catatan: Tidak digunakan lagi di Maps JavaScript API (KmlLayer terakhir didukung di v3.65, dinonaktifkan pada Mei 2027); konversi feed GeoRSS ke GeoJSON dan muat di lapisan Data dengan map.data.addGeoJson().
  • Menambahkan data GeoJSON ke peta.

Maps JavaScript API: Rute dan Pemilihan Rute

Maps JavaScript API: Elevation

Maps JavaScript API: Fleet Engine

Maps JavaScript API: Geocoding

Maps JavaScript API: Maps

Maps JavaScript API: Anotasi peta

Maps JavaScript API: Gaya visual peta

Maps JavaScript API: Lainnya

Maps JavaScript API: Peta 3D Fotorealistik

Maps JavaScript API: Tempat

Maps JavaScript API: Kit UI Places

  • Tambahkan elemen UI yang menampilkan ringkasan dan ulasan yang didukung AI tentang tempat tertentu ke halaman web atau aplikasi seluler. Catatan: Hanya didukung di web (Kit UI Tempat Maps JavaScript API); Kit UI Tempat seluler tidak menyertakan elemen ringkasan AI. PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), gunakan komponen Kit UI Places sisi klien dalam Maps JavaScript API, bukan memanggil layanan web Places API dari server backend. Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
  • Menerapkan gaya visual CSS ke elemen UI data tempat. Catatan: Properti kustom CSS berlaku untuk elemen Kit UI Places di Maps JavaScript API; Places SDK for Android dan Places SDK for iOS menata gaya tampilan Kit UI Tempat secara terprogram menggunakan atribut tema dan gaya. PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
  • Sesuaikan gaya visual dan konfigurasi elemen UI data tempat dengan alat penyesuaian elemen UI. Catatan: PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
  • Tambahkan elemen UI yang menampilkan informasi tentang tempat tertentu ke halaman web atau aplikasi seluler. Catatan: PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
  • Tambahkan elemen UI yang menampilkan daftar tempat berdasarkan string kueri ke halaman web. Catatan: Didukung di halaman web (Maps JavaScript API) dan aplikasi seluler (Places SDK for Android dan Places SDK for iOS). PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
  • Menambahkan elemen UI yang menampilkan daftar tempat di dekat lokasi tertentu ke halaman web. Catatan: Didukung di halaman web (Maps JavaScript API) dan aplikasi seluler (Places SDK for Android dan Places SDK for iOS). PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq
  • Menambahkan elemen UI pelengkapan otomatis dasar ke halaman web atau aplikasi yang menampilkan ID Tempat Google berdasarkan string kueri. Catatan: PERSYARATAN KEPATUHAN EEA: Untuk menampilkan data tempat di peta di Wilayah Ekonomi Eropa (EEA), jangan panggil layanan web Places API dari server backend. Gunakan komponen Kit UI Tempat sisi klien di platform target (Maps JavaScript API di web, Places SDK for Android di Android, atau Places SDK for iOS di iOS). Persyaratan lengkap dan FAQ: https://developers.google.com/maps/comms/eea/faq

Maps JavaScript API: Street View