Class StaticMap

StaticMap

Memungkinkan pembuatan dan dekorasi gambar peta statis.

Contoh di bawah menunjukkan cara menggunakan kelas ini untuk membuat peta Teater New York City Distrik, termasuk stasiun kereta terdekat, dan menampilkannya di aplikasi web sederhana.

// Create a map centered on Times Square.
var map = Maps.newStaticMap()
    .setSize(600, 600)
    .setCenter('Times Square, New York, NY');

// Add markers for the nearbye train stations.
map.setMarkerStyle(Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.RED, 'T');
map.addMarker('Grand Central Station, New York, NY');
map.addMarker('Penn Station, New York, NY');

// Show the boundaries of the Theatre District.
var corners = [
  '8th Ave & 53rd St, New York, NY',
  '6th Ave & 53rd St, New York, NY',
  '6th Ave & 40th St, New York, NY',
  '8th Ave & 40th St, New York, NY'
];
map.setPathStyle(4, Maps.StaticMap.Color.BLACK, Maps.StaticMap.Color.BLUE);
map.beginPath();
for (var i = 0; i < corners.length; i++) {
  map.addAddress(corners[i]);
}
// All static map URLs require an API key.
var url = map.getMapUrl() + "&key=YOUR_API_KEY";

Lihat juga

• Google Static Maps API

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
addAddress(address)	StaticMap	Menambahkan alamat baru ke definisi jalur saat ini.
addMarker(latitude, longitude)	StaticMap	Menambahkan penanda ke peta menggunakan titik (lat/lng).
addMarker(address)	StaticMap	Menambahkan penanda ke peta menggunakan alamat.
addPath(points)	StaticMap	Menambahkan jalur ke peta menggunakan array titik.
addPath(polyline)	StaticMap	Menambahkan jalur ke peta menggunakan polyline yang dienkode.
addPoint(latitude, longitude)	StaticMap	Menambahkan titik baru (lat/lng) ke definisi jalur saat ini.
addVisible(latitude, longitude)	StaticMap	Menambahkan lokasi titik (lat/lng) yang harus terlihat di peta.
addVisible(address)	StaticMap	Menambahkan lokasi alamat yang harus terlihat di peta.
beginPath()	StaticMap	Memulai definisi jalur baru.
clearMarkers()	StaticMap	Menghapus kumpulan penanda saat ini.
clearPaths()	StaticMap	Mengosongkan kumpulan jalur saat ini.
clearVisibles()	StaticMap	Menghapus kumpulan lokasi yang terlihat saat ini.
endPath()	StaticMap	Menyelesaikan definisi jalur yang dimulai dengan beginPath().
getAs(contentType)	Blob	Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan.
getBlob()	Blob	Mendapatkan data gambar sebagai Blob.
getMapImage()	Byte[]	Mendapatkan data gambar mentah sebagai array byte.
getMapUrl()	String	Mendapatkan URL gambar peta.
setCenter(latitude, longitude)	StaticMap	Menetapkan pusat peta menggunakan titik (lat/lng).
setCenter(address)	StaticMap	Menetapkan bagian tengah peta menggunakan alamat.
setCustomMarkerStyle(imageUrl, useShadow)	StaticMap	Menetapkan gambar penanda kustom yang akan digunakan saat membuat penanda baru.
setFormat(format)	StaticMap	Menetapkan format gambar peta.
setLanguage(language)	StaticMap	Menetapkan bahasa yang akan digunakan untuk teks di peta (jika tersedia).
setMapType(mapType)	StaticMap	Menetapkan jenis peta yang akan ditampilkan.
setMarkerStyle(size, color, label)	StaticMap	Menetapkan gaya penanda yang akan digunakan saat membuat penanda baru.
setMobile(useMobileTiles)	StaticMap	Menetapkan apakah akan menggunakan kumpulan kartu khusus untuk perangkat seluler atau tidak.
setPathStyle(weight, color, fillColor)	StaticMap	Menetapkan gaya jalur yang akan digunakan saat membuat jalur baru.
setSize(width, height)	StaticMap	Menetapkan lebar dan tinggi gambar peta dalam piksel.
setZoom(zoom)	StaticMap	Menetapkan faktor zoom, atau tingkat pembesaran, yang digunakan untuk peta.

Dokumentasi mendetail

addAddress(address)

Menambahkan alamat baru ke definisi jalur saat ini.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

Parameter

Nama	Jenis	Deskripsi
address	String	Alamat untuk ditambahkan.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

---

addMarker(latitude, longitude)

Menambahkan penanda ke peta menggunakan titik (lat/lng).

// Creates a map and adds a marker at the specified coordinates.
var map = Maps.newStaticMap().addMarker(40.741799, -74.004207);

Parameter

Nama	Jenis	Deskripsi
latitude	Number	Lintang penanda baru.
longitude	Number	Garis bujur penanda baru.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Google Static Maps API

---

addMarker(address)

Menambahkan penanda ke peta menggunakan alamat.

// Creates a map and adds a marker at the specified address.
var map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');

Parameter

Nama	Jenis	Deskripsi
address	String	Alamat yang digunakan untuk menempatkan penanda baru.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Google Static Maps API

---

addPath(points)

Menambahkan jalur ke peta menggunakan array titik.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .addPath([40.714353, -74.005973, 42.358431, -71.059773]);

Parameter

Nama	Jenis	Deskripsi
points	Number[]	Array pasangan garis lintang/bujur yang mendefinisikan jalur.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

---

addPath(polyline)

Menambahkan jalur ke peta menggunakan polyline yang dienkode.

// Creates a map and adds a path from New York to Boston.
var polyline = Maps.encodePolyline([40.714353, -74.005973, 42.358431, -71.059773]);
var map = Maps.newStaticMap().addPath(polyline);

Parameter

Nama	Jenis	Deskripsi
polyline	String	Polyline yang dienkode.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

---

addPoint(latitude, longitude)

Menambahkan titik baru (lat/lng) ke definisi jalur saat ini.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addPoint(40.714353, -74.005973)
    .addPoint(42.358431, -71.059773)
    .endPath();

Parameter

Nama	Jenis	Deskripsi
latitude	Number	Lintang titik.
longitude	Number	Garis bujur titik.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

---

addVisible(latitude, longitude)

Menambahkan lokasi titik (lat/lng) yang harus terlihat di peta.

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible(40.714353, -74.005973);
    .addVisible(42.358431, -71.059773)

Parameter

Nama	Jenis	Deskripsi
latitude	Number	Lintang titik.
longitude	Number	Garis bujur titik.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Google Static Maps API

---

addVisible(address)

Menambahkan lokasi alamat yang harus terlihat di peta.

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible('New York, NY')
    .addVisible('Boston, MA');

Parameter

Nama	Jenis	Deskripsi
address	String	Alamat yang harus terlihat di peta.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Google Static Maps API

---

beginPath()

Memulai definisi jalur baru. Panggilan ke addAddress() dan addPoint() menentukan setiap panggilan verteks baru di jalur. Jalur diselesaikan saat endPath() dipanggil.

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

---

clearMarkers()

Menghapus kumpulan penanda saat ini.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all markers on the map.
map.clearMarkers();

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

---

clearPaths()

Mengosongkan kumpulan jalur saat ini.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all paths on the map.
map.clearPaths();

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

---

clearVisibles()

Menghapus kumpulan lokasi yang terlihat saat ini.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all visible locations created with addVisible().
map.clearVisibles();

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

---

endPath()

Menyelesaikan definisi jalur yang dimulai dengan beginPath().

// Creates a map and adds a path from New York to Boston.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

---

getAs(contentType)

Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. Ini menambahkan ekstensi yang sesuai ke nama file—misalnya, "myfile.pdf". Namun, mengasumsikan bahwa bagian dari nama {i>file<i} yang mengikuti titik terakhir (jika ada) adalah bagian yang harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".

Untuk melihat kuota harian untuk konversi, lihat Kuota untuk Google Layanan. Domain Google Workspace yang baru dibuat mungkin tunduk kepada aturan yang lebih ketat kuota tambahan.

Parameter

Nama	Jenis	Deskripsi
contentType	String	Jenis MIME yang menjadi tujuan konversi. Untuk sebagian besar blob, 'application/pdf' adalah satu-satunya opsi yang valid. Untuk gambar dalam format BMP, GIF, JPEG, atau PNG, dari 'image/bmp', 'image/gif', 'image/jpeg', atau 'image/png' juga valid. Untuk dokumen Google Dokumen, 'text/markdown' juga valid.

Pulang pergi

Blob — Data sebagai blob.

---

getBlob()

Mendapatkan data gambar sebagai Blob.

// Creates a map centered on Times Square and saves it to Google Drive.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DocsList.createFile(map);  // You can call map.getBlob() explicitly or use it
                           // implicitly by passing the map where a blob is expected.

Pulang pergi

Blob — Gambar peta dalam format gambar yang dipilih.

---

getMapImage()

Mendapatkan data gambar mentah sebagai array byte.

Secara umum, lebih suka menggunakan getBlob() yang memungkinkan interaksi yang lebih sederhana dengan layanan IT perusahaan mereka.

// Creates a map centered on Times Square and saves it to Google Drive.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DocsList.createFile(Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'));

Pulang pergi

Byte[] — Gambar peta dalam format gambar yang dipilih.

---

getMapUrl()

Mendapatkan URL gambar peta.

// Creates a map centered on Times Square and gets the URL.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
// All static map URLs require an API key.
Logger.log(map.getMapUrl() + "&key=YOUR_API_KEY");

Pulang pergi

String — URL URL gambar peta.

---

setCenter(latitude, longitude)

Menetapkan pusat peta menggunakan titik (lat/lng).

// Creates a map centered on Times Square, using its coordinates.
var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

Parameter

Nama	Jenis	Deskripsi
latitude	Number	Lintang pusat.
longitude	Number	Garis bujur pusat.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Google Static Maps API

---

setCenter(address)

Menetapkan bagian tengah peta menggunakan alamat.

// Creates a map centered on Times Square, using its address.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');

Parameter

Nama	Jenis	Deskripsi
address	String	Alamat pusat informasi tersebut.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Google Static Maps API

---

setCustomMarkerStyle(imageUrl, useShadow)

Menetapkan gambar penanda kustom yang akan digunakan saat membuat penanda baru. Penanda yang sudah pernah yang ditambahkan tidak akan terpengaruh.

// Creates a map with markers set to be medium sized, black, and labeled with the number "1".
var map = Maps.newStaticMap()
    .setCustomMarkerStyle('http://www.example.com/marker.png', false);

Parameter

Nama	Jenis	Deskripsi
imageUrl	String	Menentukan URL yang akan digunakan sebagai ikon kustom penanda. Gambar boleh dalam format PNG, JPEG atau GIF, tetapi sebaiknya gunakan PNG.
useShadow	Boolean	Menunjukkan bahwa penanda harus menghasilkan bayangan, berdasarkan atribut area yang terlihat dan opasitas/transparansinya.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Google Static Maps API

---

setFormat(format)

Menetapkan format gambar peta.

// Creates a map with the image format set to PNG.
var map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

Parameter

Nama	Jenis	Deskripsi
format	String	Nilai konstanta dari Format.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Google Static Maps API

---

setLanguage(language)

Menetapkan bahasa yang akan digunakan untuk teks di peta (jika tersedia).

// Creates a map with the language set to French.
var map = Maps.newStaticMap().setLanguage('fr');

Parameter

Nama	Jenis	Deskripsi
language	String	ID bahasa BCP-47.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Dukungan Bahasa di Google Maps API

---

setMapType(mapType)

Menetapkan jenis peta yang akan ditampilkan.

// Creates a satellite map.
var map = Maps.newStaticMap().setMapType(Maps.StaticMap.Type.SATELLITE);

Parameter

Nama	Jenis	Deskripsi
mapType	String	Nilai konstanta dari Type.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Google Static Maps API

---

setMarkerStyle(size, color, label)

Menetapkan gaya penanda yang akan digunakan saat membuat penanda baru. Penanda yang telah ditambahkan tidak terpengaruh.

// Creates a map with markers set to be medium sized, black, and labeled with the number "1".
var map = Maps.newStaticMap()
    .setMarkerStyle(Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.BLACK , '1');

Parameter

Nama	Jenis	Deskripsi
size	String	Nilai konstanta dari MarkerSize.
color	String	String dalam format "0xrrggbb" atau nilai konstanta dari Color.
label	String	String yang berisi satu karakter A-Z atau 0-9.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Google Static Maps API

---

setMobile(useMobileTiles)

Menetapkan apakah akan menggunakan kumpulan kartu khusus untuk perangkat seluler atau tidak.

// Creates a map that uses mobile-friendly tiles.
var map = Maps.newStaticMap().setMobile(true);

Parameter

Nama	Jenis	Deskripsi
useMobileTiles	Boolean	Apakah akan menggunakan kartu seluler atau tidak.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

---

setPathStyle(weight, color, fillColor)

Menetapkan gaya jalur yang akan digunakan saat membuat jalur baru. Jalur yang telah ditambahkan tidak terdampak.

// Creates a map with paths set to be 1 pixel wide with a black line and a white fill.
var map = Maps.newStaticMap()
    .setPathStyle(1, Maps.StaticMap.Color.BLACK , 'red');

Parameter

Nama	Jenis	Deskripsi
weight	Integer	Lebar garis dalam piksel.
color	String	Warna garis, sebagai string dalam format "0xrrggbb" atau nilai konstan dari Color.
fillColor	String	Warna isian, string dalam format "0xrrggbb" atau nilai konstan dari Color.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Google Static Maps API

---

setSize(width, height)

Menetapkan lebar dan tinggi gambar peta dalam piksel.

// Creates a map 400px wide by 300px high.
var map = Maps.newStaticMap().setSize(400, 300);

Parameter

Nama	Jenis	Deskripsi
width	Integer	Lebar gambar dalam piksel.
height	Integer	Tinggi gambar dalam piksel.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Google Static Maps API

---

setZoom(zoom)

Menetapkan faktor zoom, atau tingkat pembesaran, yang digunakan untuk peta.

// Creates a map with a zoom factor of 10.
var map = Maps.newStaticMap().setZoom(10);

Parameter

Nama	Jenis	Deskripsi
zoom	Integer	Nilai dari nol hingga 21, inklusif.

Pulang pergi

StaticMap — Instance peta ini, untuk perantaian.

Lihat juga

• Google Static Maps API