Memungkinkan pembuatan dan dekorasi gambar peta statis.
Contoh di bawah menunjukkan cara menggunakan kelas ini untuk membuat peta Distrik Teater New York City, termasuk stasiun kereta terdekat, dan menampilkannya dalam 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
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 | Hapus 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 bagian tengah 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 pada 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 | Menyetel apakah akan menggunakan rangkaian ubin 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 yang akan ditambahkan. |
Return
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 | Garis lintang penanda baru. |
longitude | Number | Garis bujur penanda baru. |
Return
StaticMap
— Instance peta ini untuk perantaian.
Lihat juga
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 akan menempatkan penanda baru. |
Return
StaticMap
— Instance peta ini untuk perantaian.
Lihat juga
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 menentukan jalur. |
Return
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. |
Return
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 | Garis lintang titik tersebut. |
longitude | Number | Bujur titik. |
Return
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 | Garis lintang titik tersebut. |
longitude | Number | Bujur titik. |
Return
StaticMap
— Instance peta ini untuk perantaian.
Lihat juga
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. |
Return
StaticMap
— Instance peta ini untuk perantaian.
Lihat juga
beginPath()
Memulai definisi jalur baru. Panggilan ke addAddress()
dan addPoint()
menentukan setiap
verteks baru di jalur. Jalur akan 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();
Return
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();
Return
StaticMap
— Instance peta ini untuk perantaian.
clearPaths()
Hapus kumpulan jalur saat ini.
var map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
Return
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();
Return
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();
Return
StaticMap
— Instance peta ini untuk perantaian.
getAs(contentType)
Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. Metode ini menambahkan ekstensi yang sesuai ke nama file—misalnya, "myfile.pdf". Namun, dianggap bahwa bagian nama file yang mengikuti titik terakhir (jika ada) adalah ekstensi yang sudah ada dan harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".
Untuk melihat kuota harian konversi, lihat Kuota untuk Layanan Google. Domain Google Workspace yang baru dibuat untuk sementara mungkin dikenai kuota yang lebih ketat.
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, 'image/bmp' , 'image/gif' , 'image/jpeg' , atau 'image/png' juga
valid. |
Return
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.
Return
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 lebih sederhana dengan layanan
lain.
// 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'));
Return
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");
Return
String
— URL URL gambar peta.
setCenter(latitude, longitude)
Menetapkan bagian tengah 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 | Garis lintang pusat. |
longitude | Number | Garis bujur tengah. |
Return
StaticMap
— Instance peta ini untuk perantaian.
Lihat juga
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. |
Return
StaticMap
— Instance peta ini untuk perantaian.
Lihat juga
setCustomMarkerStyle(imageUrl, useShadow)
Menetapkan gambar penanda kustom yang akan digunakan saat membuat penanda baru. Penanda yang telah 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, meskipun sebaiknya PNG. |
useShadow | Boolean | Menunjukkan bahwa penanda harus memiliki bayangan yang dihasilkan, berdasarkan wilayah gambar yang terlihat dan opasitas/transparansinya. |
Return
StaticMap
— Instance peta ini untuk perantaian.
Lihat juga
setFormat(format)
setLanguage(language)
Menetapkan bahasa yang akan digunakan untuk teks pada 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. |
Return
StaticMap
— Instance peta ini untuk perantaian.
Lihat juga
setMapType(mapType)
setMarkerStyle(size, color, label)
Menetapkan gaya penanda yang akan digunakan saat membuat penanda baru. Penanda yang telah 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() .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. |
Return
StaticMap
— Instance peta ini untuk perantaian.
Lihat juga
setMobile(useMobileTiles)
Menyetel apakah akan menggunakan rangkaian ubin 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 kartu seluler akan digunakan atau tidak. |
Return
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 terpengaruh.
// 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 konstanta dari
Color . |
fillColor | String | Warna isian, string dalam format "0xrrggbb" atau nilai konstanta dari
Color . |
Return
StaticMap
— Instance peta ini untuk perantaian.
Lihat juga
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. |
Return
StaticMap
— Instance peta ini untuk perantaian.
Lihat juga
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. |
Return
StaticMap
— Instance peta ini untuk perantaian.