Class StaticMap

StaticMap

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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
addAddress(address)StaticMapMenambahkan alamat baru ke definisi jalur saat ini.
addMarker(latitude, longitude)StaticMapMenambahkan penanda ke peta menggunakan titik (lat/lng).
addMarker(address)StaticMapMenambahkan penanda ke peta menggunakan alamat.
addPath(points)StaticMapMenambahkan jalur ke peta menggunakan array titik.
addPath(polyline)StaticMapMenambahkan jalur ke peta menggunakan polyline yang dienkode.
addPoint(latitude, longitude)StaticMapMenambahkan titik baru (lat/lng) ke definisi jalur saat ini.
addVisible(latitude, longitude)StaticMapMenambahkan lokasi titik (lat/lng) yang harus terlihat di peta.
addVisible(address)StaticMapMenambahkan lokasi alamat yang harus terlihat di peta.
beginPath()StaticMapMemulai definisi jalur baru.
clearMarkers()StaticMapMenghapus kumpulan penanda saat ini.
clearPaths()StaticMapMenghapus kumpulan jalur saat ini.
clearVisibles()StaticMapMenghapus kumpulan lokasi yang terlihat saat ini.
endPath()StaticMapMenyelesaikan definisi jalur yang dimulai dengan beginPath().
getAs(contentType)BlobMenampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan.
getBlob()BlobMendapatkan data gambar sebagai Blob.
getMapImage()Byte[]Mendapatkan data gambar mentah sebagai array byte.
getMapUrl()StringMendapatkan URL gambar peta.
setCenter(latitude, longitude)StaticMapMenetapkan bagian tengah peta menggunakan titik (lat/lng).
setCenter(address)StaticMapMenetapkan bagian tengah peta menggunakan alamat.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapMenetapkan gambar penanda kustom yang akan digunakan saat membuat penanda baru.
setFormat(format)StaticMapMenetapkan format gambar peta.
setLanguage(language)StaticMapMenetapkan bahasa yang akan digunakan untuk teks pada peta (jika tersedia).
setMapType(mapType)StaticMapMenetapkan jenis peta yang akan ditampilkan.
setMarkerStyle(size, color, label)StaticMapMenetapkan gaya penanda yang akan digunakan saat membuat penanda baru.
setMobile(useMobileTiles)StaticMapMenetapkan apakah akan menggunakan set kartu khusus untuk perangkat seluler atau tidak.
setPathStyle(weight, color, fillColor)StaticMapMenetapkan gaya jalur yang akan digunakan saat membuat jalur baru.
setSize(width, height)StaticMapMenetapkan lebar dan tinggi gambar peta dalam piksel.
setZoom(zoom)StaticMapMenetapkan 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.
const map = Maps.newStaticMap()
                .beginPath()
                .addAddress('New York, NY')
                .addAddress('Boston, MA')
                .endPath();

Parameter

NamaJenisDeskripsi
addressStringAlamat yang akan ditambahkan.

Pulang pergi

StaticMap — Instance peta ini, untuk penyambungan.


addMarker(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

NamaJenisDeskripsi
latitudeNumberLintang penanda baru.
longitudeNumberGaris bujur penanda baru.

Pulang pergi

StaticMap — Instance peta ini, untuk penyambungan.

Lihat juga


addMarker(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

NamaJenisDeskripsi
addressStringAlamat tempat penanda baru akan ditempatkan.

Pulang pergi

StaticMap — Instance peta ini, untuk pembuatan rantai.

Lihat juga


addPath(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

NamaJenisDeskripsi
pointsNumber[]Array pasangan lintang/bujur yang menentukan jalur.

Pulang pergi

StaticMap — Instance peta ini, untuk pembuatan rantai.


addPath(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

NamaJenisDeskripsi
polylineStringPolyline yang dienkode.

Pulang pergi

StaticMap — Instance peta ini, untuk pembuatan rantai.


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.
const map = Maps.newStaticMap()
                .beginPath()
                .addPoint(40.714353, -74.005973)
                .addPoint(42.358431, -71.059773)
                .endPath();

Parameter

NamaJenisDeskripsi
latitudeNumberLintang titik.
longitudeNumberBujur titik.

Pulang pergi

StaticMap — Instance peta ini, untuk pembuatan rantai.


addVisible(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

NamaJenisDeskripsi
latitudeNumberLintang titik.
longitudeNumberBujur titik.

Pulang pergi

StaticMap — Instance peta ini, untuk pembuatan rantai.

Lihat juga


addVisible(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

NamaJenisDeskripsi
addressStringAlamat yang harus terlihat di peta.

Pulang pergi

StaticMap — Instance peta ini, untuk penyambungan.

Lihat juga


beginPath()

Memulai definisi jalur baru. Panggilan ke addAddress() dan addPoint() menentukan setiap verteks baru di jalur. Jalur selesai saat endPath() 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

StaticMap — Instance peta ini, untuk penyambungan.


clearMarkers()

Menghapus kumpulan penanda saat ini.

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

Pulang pergi

StaticMap — Instance peta ini, untuk pembuatan rantai.


clearPaths()

Menghapus kumpulan jalur saat ini.

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

Pulang pergi

StaticMap — Instance peta ini, untuk penyambungan.


clearVisibles()

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

StaticMap — Instance peta ini, untuk pembuatan rantai.


endPath()

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

StaticMap — Instance peta ini, untuk pembuatan rantai.


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, 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

NamaJenisDeskripsi
contentTypeStringJenis 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.


getBlob()

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.


getMapImage()

Mendapatkan data gambar mentah sebagai array byte.

Secara umum, sebaiknya gunakan getBlob() 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.


getMapUrl()

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.


setCenter(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

NamaJenisDeskripsi
latitudeNumberLintang pusat.
longitudeNumberBujur pusat.

Pulang pergi

StaticMap — Instance peta ini, untuk pembuatan rantai.

Lihat juga


setCenter(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

NamaJenisDeskripsi
addressStringAlamat pusat.

Pulang pergi

StaticMap — Instance peta ini, untuk pembuatan rantai.

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".
const map = Maps.newStaticMap().setCustomMarkerStyle(
    'http://www.example.com/marker.png',
    false,
);

Parameter

NamaJenisDeskripsi
imageUrlStringMenentukan URL yang akan digunakan sebagai ikon khusus penanda. Gambar dapat dalam format PNG, JPEG, atau GIF, meskipun yang disarankan adalah PNG.
useShadowBooleanMenunjukkan bahwa penanda harus memiliki bayangan yang dihasilkan, berdasarkan area gambar yang terlihat dan opasitas/transparansi.

Pulang pergi

StaticMap — Instance peta ini, untuk pembuatan rantai.

Lihat juga


setFormat(format)

Menetapkan format gambar peta.

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

Parameter

NamaJenisDeskripsi
formatStringNilai konstan dari Format.

Pulang pergi

StaticMap — Instance peta ini, untuk penyambungan.

Lihat juga


setLanguage(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

NamaJenisDeskripsi
languageStringID bahasa BCP-47.

Pulang pergi

StaticMap — Instance peta ini, untuk pembuatan rantai.

Lihat juga


setMapType(mapType)

Menetapkan jenis peta yang akan ditampilkan.

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

Parameter

NamaJenisDeskripsi
mapTypeStringNilai konstan dari Type.

Pulang pergi

StaticMap — Instance peta ini, untuk penyambungan.

Lihat juga


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".
const map = Maps.newStaticMap().setMarkerStyle(
    Maps.StaticMap.MarkerSize.MID,
    Maps.StaticMap.Color.BLACK,
    '1',
);

Parameter

NamaJenisDeskripsi
sizeStringNilai konstan dari MarkerSize.
colorStringString dalam format "0xrrggbb" atau nilai konstan dari Color.
labelStringString yang berisi satu karakter A-Z atau 0-9.

Pulang pergi

StaticMap — Instance peta ini, untuk penyambungan.

Lihat juga


setMobile(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

NamaJenisDeskripsi
useMobileTilesBooleanApakah akan menggunakan kartu seluler atau tidak.

Pulang pergi

StaticMap — Instance peta ini, untuk pembuatan rantai.


setPathStyle(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

NamaJenisDeskripsi
weightIntegerLebar garis dalam piksel.
colorStringWarna garis, sebagai string dalam format "0xrrggbb" atau nilai konstan dari Color.
fillColorStringWarna isian, string dalam format "0xrrggbb" atau nilai konstan dari Color.

Pulang pergi

StaticMap — Instance peta ini, untuk penyambungan.

Lihat juga


setSize(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

NamaJenisDeskripsi
widthIntegerLebar gambar dalam piksel.
heightIntegerTinggi gambar dalam piksel.

Pulang pergi

StaticMap — Instance peta ini, untuk penyambungan.

Lihat juga


setZoom(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

NamaJenisDeskripsi
zoomIntegerNilai dari nol hingga 21, inklusif.

Pulang pergi

StaticMap — Instance peta ini, untuk pembuatan rantai.

Lihat juga