Memungkinkan pembuatan dan dekorasi gambar peta statis.
Contoh di bawah menunjukkan cara menggunakan class ini untuk membuat peta Distrik Teeater New York City, termasuk stasiun kereta di dekatnya, dan menampilkannya di aplikasi web sederhana.
// Create a map centered on Times Square. const 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. const 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 (let i = 0; i < corners.length; i++) { map.addAddress(corners[i]); } // All static map URLs require an API key. const url = `${map.getMapUrl()}&key=YOUR_API_KEY`;
Lihat juga
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
add | Static | Menambahkan alamat baru ke definisi jalur saat ini. |
add | Static | Menambahkan penanda ke peta menggunakan titik (lat/lng). |
add | Static | Menambahkan penanda ke peta menggunakan alamat. |
add | Static | Menambahkan jalur ke peta menggunakan array titik. |
add | Static | Menambahkan jalur ke peta menggunakan polyline yang dienkode. |
add | Static | Menambahkan titik baru (lat/lng) ke definisi jalur saat ini. |
add | Static | Menambahkan lokasi titik (lat/lng) yang harus terlihat di peta. |
add | Static | Menambahkan lokasi alamat yang harus terlihat di peta. |
begin | Static | Memulai definisi jalur baru. |
clear | Static | Menghapus kumpulan penanda saat ini. |
clear | Static | Menghapus kumpulan jalur saat ini. |
clear | Static | Menghapus kumpulan lokasi yang terlihat saat ini. |
end | Static | Menyelesaikan definisi jalur yang dimulai dengan beginPath(). |
get | Blob | Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. |
get | Blob | Mendapatkan data gambar sebagai Blob . |
get | Byte[] | Mendapatkan data gambar mentah sebagai array byte. |
get | String | Mendapatkan URL gambar peta. |
set | Static | Menetapkan bagian tengah peta menggunakan titik (lat/lng). |
set | Static | Menetapkan bagian tengah peta menggunakan alamat. |
set | Static | Menetapkan gambar penanda kustom yang akan digunakan saat membuat penanda baru. |
set | Static | Menetapkan format gambar peta. |
set | Static | Menetapkan bahasa yang akan digunakan untuk teks pada peta (jika tersedia). |
set | Static | Menetapkan jenis peta yang akan ditampilkan. |
set | Static | Menetapkan gaya penanda yang akan digunakan saat membuat penanda baru. |
set | Static | Menetapkan apakah akan menggunakan set kartu khusus untuk perangkat seluler atau tidak. |
set | Static | Menetapkan gaya jalur yang akan digunakan saat membuat jalur baru. |
set | Static | Menetapkan lebar dan tinggi gambar peta dalam piksel. |
set | Static | Menetapkan faktor zoom, atau tingkat pembesaran, yang digunakan untuk peta. |
Dokumentasi mendetail
add Address(address)
Menambahkan alamat baru ke definisi jalur saat ini.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
address | String | Alamat yang akan ditambahkan. |
Pulang pergi
Static
— Instance peta ini, untuk pembuatan rantai.
add Marker(latitude, longitude)
Menambahkan penanda ke peta menggunakan titik (lat/lng).
// Creates a map and adds a marker at the specified coordinates. const 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
Static
— Instance peta ini, untuk penyambungan.
Lihat juga
add Marker(address)
Menambahkan penanda ke peta menggunakan alamat.
// Creates a map and adds a marker at the specified address. const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
address | String | Alamat tempat penanda baru akan ditempatkan. |
Pulang pergi
Static
— Instance peta ini, untuk penyambungan.
Lihat juga
add Path(points)
Menambahkan jalur ke peta menggunakan array titik.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap().addPath([ 40.714353, -74.005973, 42.358431, -71.059773, ]);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
points | Number[] | Array pasangan lintang/bujur yang menentukan jalur. |
Pulang pergi
Static
— Instance peta ini, untuk penyambungan.
add Path(polyline)
Menambahkan jalur ke peta menggunakan polyline yang dienkode.
// Creates a map and adds a path from New York to Boston. const polyline = Maps.encodePolyline([ 40.714353, -74.005973, 42.358431, -71.059773, ]); const map = Maps.newStaticMap().addPath(polyline);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
polyline | String | Polyline yang dienkode. |
Pulang pergi
Static
— Instance peta ini, untuk pembuatan rantai.
add Point(latitude, longitude)
Menambahkan titik baru (lat/lng) ke definisi jalur saat ini.
// Creates a map and adds a path from New York to Boston. const 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 | Bujur titik. |
Pulang pergi
Static
— Instance peta ini, untuk pembuatan rantai.
add Visible(latitude, longitude)
Menambahkan lokasi titik (lat/lng) yang harus terlihat di peta.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap() .addVisible(40.714353, -74.005973) .addVisible(42.358431, -71.059773);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
latitude | Number | Lintang titik. |
longitude | Number | Bujur titik. |
Pulang pergi
Static
— Instance peta ini, untuk pembuatan rantai.
Lihat juga
add Visible(address)
Menambahkan lokasi alamat yang harus terlihat di peta.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
address | String | Alamat yang harus terlihat di peta. |
Pulang pergi
Static
— Instance peta ini, untuk penyambungan.
Lihat juga
begin Path()
Memulai definisi jalur baru. Panggilan ke add
dan add
menentukan setiap
verteks baru di jalur. Jalur selesai saat end
dipanggil.
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Pulang pergi
Static
— Instance peta ini, untuk penyambungan.
clear Markers()
Menghapus kumpulan penanda saat ini.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
Pulang pergi
Static
— Instance peta ini, untuk penyambungan.
clear Paths()
Menghapus kumpulan jalur saat ini.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
Pulang pergi
Static
— Instance peta ini, untuk penyambungan.
clear Visibles()
Menghapus kumpulan lokasi yang terlihat saat ini.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
Pulang pergi
Static
— Instance peta ini, untuk penyambungan.
end Path()
Menyelesaikan definisi jalur yang dimulai dengan beginPath().
// Creates a map and adds a path from New York to Boston. const map = Maps.newStaticMap() .beginPath() .addAddress('New York, NY') .addAddress('Boston, MA') .endPath();
Pulang pergi
Static
— Instance peta ini, untuk penyambungan.
get As(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, hal ini menganggap bahwa bagian nama file yang mengikuti titik terakhir (jika ada) adalah ekstensi yang 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 mungkin akan dikenai kuota yang lebih ketat untuk sementara.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
content | String | Jenis MIME yang akan dikonversi. 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. Untuk dokumen Google Dokumen, 'text/markdown' juga valid. |
Pulang pergi
Blob
— Data sebagai blob.
get Blob()
Mendapatkan data gambar sebagai Blob
.
// Creates a map centered on Times Square and saves it to Google Drive. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DriveApp.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.
get Map Image()
Mendapatkan data gambar mentah sebagai array byte.
Secara umum, sebaiknya gunakan get
yang memungkinkan interaksi yang lebih sederhana dengan layanan
lain.
// Creates a map centered on Times Square and saves it to Google Drive. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY'); DriveApp.createFile( Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'), );
Pulang pergi
Byte[]
— Gambar peta dalam format gambar yang dipilih.
get Map Url()
Mendapatkan URL gambar peta.
// Creates a map centered on Times Square and gets the URL. const 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.
set Center(latitude, longitude)
Menetapkan bagian tengah peta menggunakan titik (lat/lng).
// Creates a map centered on Times Square, using its coordinates. const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
latitude | Number | Lintang pusat. |
longitude | Number | Bujur pusat. |
Pulang pergi
Static
— Instance peta ini, untuk pembuatan rantai.
Lihat juga
set Center(address)
Menetapkan bagian tengah peta menggunakan alamat.
// Creates a map centered on Times Square, using its address. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
address | String | Alamat pusat. |
Pulang pergi
Static
— Instance peta ini, untuk penyambungan.
Lihat juga
set Custom Marker Style(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". const map = Maps.newStaticMap().setCustomMarkerStyle( 'http://www.example.com/marker.png', false, );
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
image | String | Menentukan URL yang akan digunakan sebagai ikon khusus penanda. Gambar dapat dalam format PNG, JPEG, atau GIF, meskipun yang disarankan adalah PNG. |
use | Boolean | Menunjukkan bahwa penanda harus memiliki bayangan yang dihasilkan, berdasarkan area gambar yang terlihat dan opasitas/transparansi. |
Pulang pergi
Static
— Instance peta ini, untuk penyambungan.
Lihat juga
set Format(format)
set Language(language)
Menetapkan bahasa yang akan digunakan untuk teks pada peta (jika tersedia).
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
language | String | ID bahasa BCP-47. |
Pulang pergi
Static
— Instance peta ini, untuk pembuatan rantai.
Lihat juga
set Map Type(mapType)
set Marker Style(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". const map = Maps.newStaticMap().setMarkerStyle( Maps.StaticMap.MarkerSize.MID, Maps.StaticMap.Color.BLACK, '1', );
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
size | String | Nilai konstan dari Marker . |
color | String | String dalam format "0xrrggbb" atau nilai konstan dari Color . |
label | String | String yang berisi satu karakter A-Z atau 0-9. |
Pulang pergi
Static
— Instance peta ini, untuk pembuatan rantai.
Lihat juga
set Mobile(useMobileTiles)
Menetapkan apakah akan menggunakan set kartu khusus untuk perangkat seluler atau tidak.
// Creates a map that uses mobile-friendly tiles. const map = Maps.newStaticMap().setMobile(true);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
use | Boolean | Apakah akan menggunakan kartu seluler atau tidak. |
Pulang pergi
Static
— Instance peta ini, untuk pembuatan rantai.
set Path Style(weight, color, fillColor)
Menetapkan gaya jalur yang akan digunakan saat membuat jalur baru. Jalur yang telah ditambahkan tidak akan terpengaruh.
// Creates a map with paths set to be 1 pixel wide with a black line and a white // fill. const 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 . |
fill | String | Warna isian, string dalam format "0xrrggbb" atau nilai konstan dari
Color . |
Pulang pergi
Static
— Instance peta ini, untuk penyambungan.
Lihat juga
set Size(width, height)
Menetapkan lebar dan tinggi gambar peta dalam piksel.
// Creates a map 400px wide by 300px high. const map = Maps.newStaticMap().setSize(400, 300);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
width | Integer | Lebar gambar dalam piksel. |
height | Integer | Tinggi gambar dalam piksel. |
Pulang pergi
Static
— Instance peta ini, untuk pembuatan rantai.
Lihat juga
set Zoom(zoom)
Menetapkan faktor zoom, atau tingkat pembesaran, yang digunakan untuk peta.
// Creates a map with a zoom factor of 10. const map = Maps.newStaticMap().setZoom(10);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
zoom | Integer | Nilai dari nol hingga 21, inklusif. |
Pulang pergi
Static
— Instance peta ini, untuk pembuatan rantai.