Class Maps

Maps

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

Properti

PropertiJenisDeskripsi
DirectionFinderDirectionFinderEnums
StaticMapStaticMapEnums

Metode

MetodeJenis nilai yang ditampilkanDeskripsi singkat
decodePolyline(polyline)Number[]Mendekode string polyline yang dienkode kembali menjadi array titik.
encodePolyline(points)StringMengenkode array titik menjadi string.
newDirectionFinder()DirectionFinderMembuat objek DirectionFinder baru.
newElevationSampler()ElevationSamplerMembuat objek ElevationSampler.
newGeocoder()GeocoderMembuat objek Geocoder baru.
newStaticMap()StaticMapMembuat objek StaticMap baru.
resetAuthenticationApiKey()voidMereset kredensial autentikasi untuk menggunakan alokasi kuota default.
setAuthenticationByApiKey(apiKey)voidMemungkinkan penggunaan kunci API untuk mengautentikasi permintaan guna memanfaatkan kuota tambahan.
setAuthenticationByApiKey(apiKey, signingKey)voidMemungkinkan penggunaan kunci API dan Kunci Penandatanganan untuk mengautentikasi permintaan guna memanfaatkan kuota tambahan di StaticMap.

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

NamaJenisDeskripsi
polylineStringPolyline yang dienkode untuk didekode.

Pulang pergi

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

Lihat juga

encodePolyline(points)

Mengenkode array titik menjadi 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

NamaJenisDeskripsi
pointsNumber[]Array pasangan garis lintang/bujur yang akan dienkode.

Pulang pergi

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

Lihat juga

newDirectionFinder()

Membuat objek DirectionFinder baru.

Pulang pergi

DirectionFinder — Objek pencari arah baru.

newElevationSampler()

Membuat objek ElevationSampler.

Pulang pergi

ElevationSampler — Objek sampler elevasi 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 dibebankan 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. 

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

Parameter

NamaJenisDeskripsi
apiKeyStringKunci 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 Static Map 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. Kunci ini 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

NamaJenisDeskripsi
apiKeyStringKunci API yang dapat diperoleh dari Konsol Google Cloud dengan mengikuti langkah-langkah yang disebutkan dalam panduan memulai.
signingKeyStringKunci 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

Metode yang tidak digunakan lagi