Class Maps

Maps

Memungkinkan penemuan arah, geocoding, pengambilan sampel elevasi, dan pembuatan gambar peta statis.

Properti

Properti	Jenis	Deskripsi
DirectionFinder	DirectionFinderEnums
StaticMap	StaticMapEnums

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
decodePolyline(polyline)	Number[]	Mendekode string polyline yang dienkode kembali menjadi array titik.
encodePolyline(points)	String	Mengenkode array titik ke dalam string.
newDirectionFinder()	DirectionFinder	Membuat objek DirectionFinder baru.
newElevationSampler()	ElevationSampler	Membuat objek ElevationSampler.
newGeocoder()	Geocoder	Membuat objek Geocoder baru.
newStaticMap()	StaticMap	Membuat objek StaticMap baru.
resetAuthenticationApiKey()	void	Mereset kredensial autentikasi untuk menggunakan alokasi kuota default.
setAuthenticationByApiKey(apiKey)	void	Memungkinkan penggunaan kunci API untuk mengautentikasi permintaan guna memanfaatkan kuota tambahan.
setAuthenticationByApiKey(apiKey, signingKey)	void	Memungkinkan penggunaan kunci API dan Kunci Penandatanganan untuk mengautentikasi permintaan guna memanfaatkan kuota tambahan di StaticMap.

Metode yang tidak digunakan lagi

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
setAuthentication(clientId, signingKey)	void	Memungkinkan penggunaan akun Premium Plan Google Maps API yang dibuat secara eksternal, untuk memanfaatkan alokasi kuota tambahan.

Dokumentasi mendetail

decodePolyline(polyline)

Mendekode string polyline yang dienkode kembali menjadi array titik.

// Decodes a string representation of the latitudes and longitudes of
// Minneapolis and Milwaukee respectively.
const polyline = 'qvkpG`qhxPbgyI_zq_@';
const points = Maps.decodePolyline(polyline);
for (let i = 0; i < points.length; i += 2) {
  Logger.log('%s, %s', points[i], points[i + 1]);
}

Parameter

Nama	Jenis	Deskripsi
polyline	String	Polyline yang dienkode untuk didekode.

Pulang pergi

Number[] — Array pasangan lintang bujur (lat0, long0, lat1, long1, ...).

Lihat juga

• Format Polyline yang Dienkodekan

---

encodePolyline(points)

Mengenkode array titik ke dalam string.

// The latitudes and longitudes of New York and Boston respectively.
const points = [40.77, -73.97, 42.34, -71.04];
const polyline = Maps.encodePolyline(points);

Parameter

Nama	Jenis	Deskripsi
points	Number[]	Array pasangan garis lintang/bujur yang akan dienkode.

Pulang pergi

String — String yang dienkode yang merepresentasikan titik-titik tersebut.

Lihat juga

• Format Polyline yang Dienkodekan

---

newDirectionFinder()

Membuat objek DirectionFinder baru.

Pulang pergi

DirectionFinder — Objek pencari arah baru.

---

newElevationSampler()

Membuat objek ElevationSampler.

Pulang pergi

ElevationSampler — Objek sampler ketinggian baru.

---

newGeocoder()

Membuat objek Geocoder baru.

Pulang pergi

Geocoder — Objek geocoder baru.

---

newStaticMap()

Membuat objek StaticMap baru.

Pulang pergi

StaticMap — Objek peta statis baru.

---

resetAuthenticationApiKey()

Mereset kredensial autentikasi untuk menggunakan alokasi kuota default. Metode ini berfungsi saat Anda menggunakan kunci API untuk mengautentikasi permintaan. Metode ini dapat digunakan untuk kembali ke alokasi kuota default jika Anda ingin menggunakan metode Maps tanpa memberikan kredensial autentikasi.

Maps.resetAuthenticationApiKey();

Menampilkan

Error — jika setAuthentication(clientId, signingKey) digunakan untuk autentikasi.

---

setAuthenticationByApiKey(apiKey)

Memungkinkan penggunaan kunci API untuk mengautentikasi permintaan guna memanfaatkan kuota tambahan.

Metode ini digunakan untuk menyetel kunci API yang digunakan untuk mengautentikasi permintaan. Saat metode ini dipanggil, penggunaan kuota dan penagihan akan ditagih ke project Google Cloud yang terkait dengan kunci API yang diberikan sesuai dengan lembar harga. Anda dapat menggunakan metode Maps dengan alokasi kuota default tanpa memberikan kredensial autentikasi. Jika Anda menggunakan StaticMap, gunakan metode setAuthenticationByApiKey(apiKey, signingKey) sebagai gantinya.

Catatan: Jika Anda menggunakan client ID untuk mengautentikasi permintaan, perlu diperhatikan bahwa client ID tidak digunakan lagi sejak 26 Mei 2025 dan tidak dapat digunakan lagi setelah 31 Mei 2026. Daripada menggunakan client ID, Anda harus menggunakan kredensial Kunci API untuk mengautentikasi traffic layanan Google Maps API Anda. Untuk mengetahui detail selengkapnya, lihat panduan.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

Parameter

Nama	Jenis	Deskripsi
apiKey	String	Kunci API yang dapat diperoleh dari Konsol Google Cloud dengan mengikuti langkah-langkah yang disebutkan dalam panduan memulai.

Menampilkan

Error — jika apiKey adalah null, atau jika setAuthentication(clientId, signingKey) sudah digunakan untuk autentikasi

---

setAuthenticationByApiKey(apiKey, signingKey)

Memungkinkan penggunaan kunci API dan Kunci Penandatanganan untuk mengautentikasi permintaan guna memanfaatkan kuota tambahan di StaticMap. Meskipun signingKey diperlukan untuk permintaan ke Maps Static API, metode ini juga dapat digunakan untuk mengautentikasi layanan Maps lainnya. Dalam kasus tersebut, parameter signingKey diabaikan.

Metode ini digunakan untuk menetapkan Kunci API dan Kunci Penandatanganan yang digunakan untuk mengautentikasi permintaan. Kunci Penandatanganan diperlukan untuk StaticMap, yang menerima sejumlah kecil permintaan tanpa tanda tangan untuk tujuan pengujian, tetapi akan gagal setelah mencapai batas di produksi Anda. Detail selengkapnya dapat ditemukan di sini.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0',
'7_pry-Skg0PKxds-7nvdl91mB5=');

Parameter

Nama	Jenis	Deskripsi
apiKey	String	Kunci API yang dapat diperoleh dari Konsol Google Cloud dengan mengikuti langkah-langkah yang disebutkan dalam panduan memulai.
signingKey	String	Kunci penandatanganan yang dapat diperoleh dari Konsol Google Cloud dengan mengikuti langkah-langkah yang disebutkan dalam panduan untuk tanda tangan digital. Parameter ini diperlukan untuk StaticMap dan diabaikan untuk layanan Maps lainnya.

Menampilkan

Error — jika apiKey adalah null, atau jika setAuthentication(clientId, signingKey) sudah digunakan untuk autentikasi

Lihat juga

• setAuthenticationByApiKey(apiKey)

Metode yang tidak digunakan lagi

setAuthentication(clientId, signingKey)

Tidak digunakan lagi. Sebagai gantinya, gunakan setAuthenticationByApiKey(apiKey) yang menggunakan kunci API untuk autentikasi.

Memungkinkan penggunaan akun Premium Plan Google Maps API yang dibuat secara eksternal, untuk memanfaatkan alokasi kuota tambahan. Client ID dan kunci penandatanganan Anda dapat diperoleh dari bagian Maps di Konsol Google Cloud. Tetapkan nilai ini ke null untuk kembali menggunakan alokasi kuota default.

Catatan: Metode ini tidak berfungsi dengan kunci API. Selain itu, perlu diketahui bahwa Premium Plan tidak lagi tersedia untuk pelanggan baru. Jika Anda belum memiliki lisensi Premium Plan, jangan panggil setAuthentication(clientId, signingKey). Anda dapat menggunakan metode Maps dengan alokasi kuota default.

Maps.setAuthentication('gme-123456789', 'VhSEZvOXVSdnlxTnpJcUE');

Parameter

Nama	Jenis	Deskripsi
clientId	String	ID klien.
signingKey	String	Kunci penandatanganan pribadi.

Menampilkan

Error — jika setAuthenticationByApiKey(apiKey) sudah digunakan untuk autentikasi