Statik harita görüntüleri oluşturulmasına ve süslenmesine olanak tanır.
Aşağıdaki örnekte, bu sınıfı kullanarak New York City'deki tiyatro bölgesinin haritasını (yakındaki tren istasyonları dahil) nasıl oluşturabileceğiniz ve basit bir web uygulamasında nasıl gösterebileceğiniz açıklanmaktadır.
// 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`;
Aşağıdaki kaynakları da incelemenizi öneririz:
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
add | Static | Geçerli yol tanımına yeni bir adres ekler. |
add | Static | Bir nokta (enlem/boylam) kullanarak haritaya işaretçi ekler. |
add | Static | Adres kullanarak haritaya işaretçi ekler. |
add | Static | Bir nokta dizisi kullanarak haritaya yol ekler. |
add | Static | Kodlanmış bir çoklu çizgi kullanarak haritaya yol ekler. |
add | Static | Geçerli yol tanımına yeni bir nokta (enlem/boylam) ekler. |
add | Static | Haritada görünmesi gereken bir nokta (enlem/boylam) konumu ekler. |
add | Static | Haritada görünür olması gereken bir adres konumu ekler. |
begin | Static | Yeni bir yol tanımı başlatır. |
clear | Static | Mevcut işaretçi grubunu temizler. |
clear | Static | Mevcut yol grubunu temizler. |
clear | Static | Görünür konumların geçerli kümesini temizler. |
end | Static | beginPath() ile başlatılan bir yol tanımını tamamlar. |
get | Blob | Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürür. |
get | Blob | Resim verilerini Blob olarak alır. |
get | Byte[] | Ham görüntü verilerini bayt dizisi olarak alır. |
get | String | Harita resminin URL'sini alır. |
set | Static | Haritanın merkezini bir nokta (enlem/boylam) kullanarak ayarlar. |
set | Static | Haritanın merkezini bir adres kullanarak ayarlar. |
set | Static | Yeni işaretçiler oluştururken kullanılacak özel işaretçi resmini ayarlar. |
set | Static | Harita resminin biçimini ayarlar. |
set | Static | Haritadaki metinlerde (varsa) kullanılacak dili ayarlar. |
set | Static | Gösterilecek harita türünü ayarlar. |
set | Static | Yeni işaretçiler oluştururken kullanılacak işaretçi stilini ayarlar. |
set | Static | Mobil cihazlar için özel döşeme kümelerinin kullanılıp kullanılmayacağını ayarlar. |
set | Static | Yeni yollar oluştururken kullanılacak yol stilini ayarlar. |
set | Static | Harita resminin genişliğini ve yüksekliğini piksel cinsinden ayarlar. |
set | Static | Harita için kullanılan yakınlaştırma faktörünü veya büyütme düzeyini ayarlar. |
Ayrıntılı belgeler
add Address(address)
Geçerli yol tanımına yeni bir adres ekler.
// 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();
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
address | String | Eklenecek bir adres. |
Return
Static: Zincirleme için bu harita örneği.
add Marker(latitude, longitude)
Bir nokta (enlem/boylam) kullanarak haritaya işaretçi ekler.
// Creates a map and adds a marker at the specified coordinates. const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
latitude | Number | Yeni işaretçinin enlemi. |
longitude | Number | Yeni işaretçinin boylamı. |
Return
Static: Zincirleme için bu harita örneği.
Aşağıdaki kaynakları da incelemenizi öneririz:
add Marker(address)
Adres kullanarak haritaya işaretçi ekler.
// Creates a map and adds a marker at the specified address. const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
address | String | Yeni işaretçinin yerleştirileceği adres. |
Return
Static: Zincirleme için bu harita örneği.
Aşağıdaki kaynakları da incelemenizi öneririz:
add Path(points)
Bir nokta dizisi kullanarak haritaya yol ekler.
// 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, ]);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
points | Number[] | Yolu tanımlayan enlem/boylam çiftleri dizisi. |
Return
Static: Zincirleme için bu harita örneği.
add Path(polyline)
Kodlanmış bir çoklu çizgi kullanarak haritaya yol ekler.
// 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);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
polyline | String | Kodlanmış bir çoklu çizgi. |
Return
Static: Zincirleme için bu harita örneği.
add Point(latitude, longitude)
Geçerli yol tanımına yeni bir nokta (enlem/boylam) ekler.
// 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();
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
latitude | Number | Noktanın enlemi. |
longitude | Number | Noktanın boylamı. |
Return
Static: Zincirleme için bu harita örneği.
add Visible(latitude, longitude)
Haritada görünmesi gereken bir nokta (enlem/boylam) konumu ekler.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap() .addVisible(40.714353, -74.005973) .addVisible(42.358431, -71.059773);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
latitude | Number | Noktanın enlemi. |
longitude | Number | Noktanın boylamı. |
Return
Static: Zincirleme için bu harita örneği.
Aşağıdaki kaynakları da incelemenizi öneririz:
add Visible(address)
Haritada görünür olması gereken bir adres konumu ekler.
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
address | String | Haritada görünür olması gereken bir adres. |
Return
Static: Zincirleme için bu harita örneği.
Aşağıdaki kaynakları da incelemenizi öneririz:
begin Path()
Yeni bir yol tanımı başlatır. add ve add çağrıları, yoldaki her yeni tepe noktasını tanımlar. end çağrıldığında yol tamamlanır.
// 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();
Return
Static: Zincirleme için bu harita örneği.
clear Markers()
Mevcut işaretçi grubunu temizler.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
Return
Static: Zincirleme için bu harita örneği.
clear Paths()
Mevcut yol grubunu temizler.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
Return
Static: Zincirleme için bu harita örneği.
clear Visibles()
Görünür konumların geçerli kümesini temizler.
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
Return
Static: Zincirleme için bu harita örneği.
end Path()
beginPath() ile başlatılan bir yol tanımını tamamlar.
// 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();
Return
Static: Zincirleme için bu harita örneği.
get As(contentType)
Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürür. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktadan sonraki kısmının (varsa) değiştirilmesi gereken mevcut bir uzantı olduğunu varsayar. Dolayısıyla, "ShoppingList.12.25.2014" ifadesi "ShoppingList.12.25.pdf" olur.
Dönüşümlerle ilgili günlük kotaları görüntülemek için Google Hizmetleri Kotaları başlıklı makaleyi inceleyin. Yeni oluşturulan Google Workspace alanları geçici olarak daha katı kotalara tabi olabilir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
content | String | Dönüştürülecek MIME türü. Çoğu blob için tek geçerli seçenek 'application/pdf''dır. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp', 'image/gif', 'image/jpeg' veya 'image/png' de geçerlidir. Google Dokümanlar dokümanları için 'text/markdown' da geçerlidir. |
Return
Blob: Veriler blob olarak.
get Blob()
Resim verilerini Blob olarak alır.
// 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.
Return
Blob: Haritanın seçili resim biçimindeki görüntüsü.
get Map Image()
Ham görüntü verilerini bayt dizisi olarak alır.
Genel olarak, diğer hizmetlerle daha basit etkileşimlere olanak tanıyan get kullanılması tercih edilir.
// 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'), );
Return
Byte[]: Haritanın seçili resim biçimindeki görüntüsü.
get Map Url()
Harita resminin URL'sini alır.
// 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`);
Return
String — URL: Harita resmi URL'si.
set Center(latitude, longitude)
Haritanın merkezini bir nokta (enlem/boylam) kullanarak ayarlar.
// Creates a map centered on Times Square, using its coordinates. const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
latitude | Number | Merkezin enlemi. |
longitude | Number | Merkezin boylamı. |
Return
Static: Zincirleme için bu harita örneği.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Center(address)
Haritanın merkezini bir adres kullanarak ayarlar.
// Creates a map centered on Times Square, using its address. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
address | String | Merkezin adresi. |
Return
Static: Zincirleme için bu harita örneği.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Custom Marker Style(imageUrl, useShadow)
Yeni işaretçiler oluştururken kullanılacak özel işaretçi resmini ayarlar. Daha önce eklenmiş işaretler etkilenmez.
// 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, );
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
image | String | İşaretçinin özel simgesi olarak kullanılacak bir URL belirtir. Resimler PNG, JPEG veya GIF biçiminde olabilir ancak PNG biçimi önerilir. |
use | Boolean | İşaretçinin, resmin görünür bölgesi ve opaklığı/şeffaflığı temel alınarak oluşturulmuş bir gölgeye sahip olması gerektiğini belirtir. |
Return
Static: Zincirleme için bu harita örneği.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Format(format)
Harita resminin biçimini ayarlar.
// Creates a map with the image format set to PNG. const map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
format | String | Format öğesinden alınan sabit bir değer. |
Return
Static: Zincirleme için bu harita örneği.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Language(language)
Haritadaki metinlerde (varsa) kullanılacak dili ayarlar.
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
language | String | BCP-47 dil tanımlayıcısı. |
Return
Static: Zincirleme için bu harita örneği.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Map Type(mapType)
Gösterilecek harita türünü ayarlar.
// Creates a satellite map. const map = Maps.newStaticMap().setMapType(Maps.StaticMap.Type.SATELLITE);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
map | String | Type öğesinden alınan sabit bir değer. |
Return
Static: Zincirleme için bu harita örneği.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Marker Style(size, color, label)
Yeni işaretçiler oluştururken kullanılacak işaretçi stilini ayarlar. Daha önce eklenmiş işaretçiler etkilenmez.
// 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', );
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
size | String | Marker öğesinden alınan sabit bir değer. |
color | String | "0xrrggbb" biçiminde bir dize veya Color sabit değeri. |
label | String | Tek bir karakter (A-Z veya 0-9) içeren dize. |
Return
Static: Zincirleme için bu harita örneği.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Mobile(useMobileTiles)
Mobil cihazlar için özel döşeme kümelerinin kullanılıp kullanılmayacağını ayarlar.
// Creates a map that uses mobile-friendly tiles. const map = Maps.newStaticMap().setMobile(true);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
use | Boolean | Mobil kutucukların kullanılıp kullanılmayacağı |
Return
Static: Zincirleme için bu harita örneği.
set Path Style(weight, color, fillColor)
Yeni yollar oluştururken kullanılacak yol stilini ayarlar. Daha önce eklenmiş yollar etkilenmez.
// 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', );
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
weight | Integer | Çizgilerin piksel cinsinden genişliği. |
color | String | Çizgi rengi, "0xrrggbb" biçiminde bir dize veya Color sabit değeri olarak. |
fill | String | Dolgu rengi, "0xrrggbb" biçiminde bir dize veya Color sabit değeri. |
Return
Static: Zincirleme için bu harita örneği.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Size(width, height)
Harita resminin genişliğini ve yüksekliğini piksel cinsinden ayarlar.
// Creates a map 400px wide by 300px high. const map = Maps.newStaticMap().setSize(400, 300);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
width | Integer | Resmin piksel cinsinden genişliği. |
height | Integer | Resmin piksel cinsinden yüksekliği. |
Return
Static: Zincirleme için bu harita örneği.
Aşağıdaki kaynakları da incelemenizi öneririz:
set Zoom(zoom)
Harita için kullanılan yakınlaştırma faktörünü veya büyütme düzeyini ayarlar.
// Creates a map with a zoom factor of 10. const map = Maps.newStaticMap().setZoom(10);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
zoom | Integer | Sıfır ile 21 arasında (bu değerler dahil) bir değer. |
Return
Static: Zincirleme için bu harita örneği.