Class StaticMap

StatikHarita

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öntemDönüş türüKısa açıklama
addAddress(address)StaticMapGeçerli yol tanımına yeni bir adres ekler.
addMarker(latitude, longitude)StaticMapBir nokta (enlem/boylam) kullanarak haritaya işaretçi ekler.
addMarker(address)StaticMapAdres kullanarak haritaya işaretçi ekler.
addPath(points)StaticMapBir nokta dizisi kullanarak haritaya yol ekler.
addPath(polyline)StaticMapKodlanmış bir çoklu çizgi kullanarak haritaya yol ekler.
addPoint(latitude, longitude)StaticMapGeçerli yol tanımına yeni bir nokta (enlem/boylam) ekler.
addVisible(latitude, longitude)StaticMapHaritada görünmesi gereken bir nokta (enlem/boylam) konumu ekler.
addVisible(address)StaticMapHaritada görünür olması gereken bir adres konumu ekler.
beginPath()StaticMapYeni bir yol tanımı başlatır.
clearMarkers()StaticMapMevcut işaretçi grubunu temizler.
clearPaths()StaticMapMevcut yol grubunu temizler.
clearVisibles()StaticMapGörünür konumların geçerli kümesini temizler.
endPath()StaticMapbeginPath() ile başlatılan bir yol tanımını tamamlar.
getAs(contentType)BlobBu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürür.
getBlob()BlobResim verilerini Blob olarak alır.
getMapImage()Byte[]Ham görüntü verilerini bayt dizisi olarak alır.
getMapUrl()StringHarita resminin URL'sini alır.
setCenter(latitude, longitude)StaticMapHaritanın merkezini bir nokta (enlem/boylam) kullanarak ayarlar.
setCenter(address)StaticMapHaritanın merkezini bir adres kullanarak ayarlar.
setCustomMarkerStyle(imageUrl, useShadow)StaticMapYeni işaretçiler oluştururken kullanılacak özel işaretçi resmini ayarlar.
setFormat(format)StaticMapHarita resminin biçimini ayarlar.
setLanguage(language)StaticMapHaritadaki metinlerde (varsa) kullanılacak dili ayarlar.
setMapType(mapType)StaticMapGösterilecek harita türünü ayarlar.
setMarkerStyle(size, color, label)StaticMapYeni işaretçiler oluştururken kullanılacak işaretçi stilini ayarlar.
setMobile(useMobileTiles)StaticMapMobil cihazlar için özel döşeme kümelerinin kullanılıp kullanılmayacağını ayarlar.
setPathStyle(weight, color, fillColor)StaticMapYeni yollar oluştururken kullanılacak yol stilini ayarlar.
setSize(width, height)StaticMapHarita resminin genişliğini ve yüksekliğini piksel cinsinden ayarlar.
setZoom(zoom)StaticMapHarita için kullanılan yakınlaştırma faktörünü veya büyütme düzeyini ayarlar.

Ayrıntılı belgeler

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

AdTürAçıklama
addressStringEklenecek bir adres.

Return

StaticMap: Zincirleme için bu harita örneği.


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

AdTürAçıklama
latitudeNumberYeni işaretçinin enlemi.
longitudeNumberYeni işaretçinin boylamı.

Return

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz:


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

AdTürAçıklama
addressStringYeni işaretçinin yerleştirileceği adres.

Return

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz:


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

AdTürAçıklama
pointsNumber[]Yolu tanımlayan enlem/boylam çiftleri dizisi.

Return

StaticMap: Zincirleme için bu harita örneği.


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

AdTürAçıklama
polylineStringKodlanmış bir çoklu çizgi.

Return

StaticMap: Zincirleme için bu harita örneği.


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

AdTürAçıklama
latitudeNumberNoktanın enlemi.
longitudeNumberNoktanın boylamı.

Return

StaticMap: Zincirleme için bu harita örneği.


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

AdTürAçıklama
latitudeNumberNoktanın enlemi.
longitudeNumberNoktanın boylamı.

Return

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz:


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

AdTürAçıklama
addressStringHaritada görünür olması gereken bir adres.

Return

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz:


beginPath()

Yeni bir yol tanımı başlatır. addAddress() ve addPoint() çağrıları, yoldaki her yeni tepe noktasını tanımlar. endPath() ç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

StaticMap: Zincirleme için bu harita örneği.


clearMarkers()

Mevcut işaretçi grubunu temizler.

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

Return

StaticMap: Zincirleme için bu harita örneği.


clearPaths()

Mevcut yol grubunu temizler.

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

Return

StaticMap: Zincirleme için bu harita örneği.


clearVisibles()

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

StaticMap: Zincirleme için bu harita örneği.


endPath()

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

StaticMap: Zincirleme için bu harita örneği.


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

AdTürAçıklama
contentTypeStringDö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.


getBlob()

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ü.


getMapImage()

Ham görüntü verilerini bayt dizisi olarak alır.

Genel olarak, diğer hizmetlerle daha basit etkileşimlere olanak tanıyan getBlob() 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ü.


getMapUrl()

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.


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

AdTürAçıklama
latitudeNumberMerkezin enlemi.
longitudeNumberMerkezin boylamı.

Return

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz:


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

AdTürAçıklama
addressStringMerkezin adresi.

Return

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz:


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

AdTürAçıklama
imageUrlStringİşaretçinin özel simgesi olarak kullanılacak bir URL belirtir. Resimler PNG, JPEG veya GIF biçiminde olabilir ancak PNG biçimi önerilir.
useShadowBooleanİş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

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz:


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

AdTürAçıklama
formatStringFormat öğesinden alınan sabit bir değer.

Return

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz:


setLanguage(language)

Haritadaki metinlerde (varsa) kullanılacak dili ayarlar.

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

Parametreler

AdTürAçıklama
languageStringBCP-47 dil tanımlayıcısı.

Return

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz:


setMapType(mapType)

Gösterilecek harita türünü ayarlar.

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

Parametreler

AdTürAçıklama
mapTypeStringType öğesinden alınan sabit bir değer.

Return

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz:


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

AdTürAçıklama
sizeStringMarkerSize öğesinden alınan sabit bir değer.
colorString"0xrrggbb" biçiminde bir dize veya Color sabit değeri.
labelStringTek bir karakter (A-Z veya 0-9) içeren dize.

Return

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz:


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

AdTürAçıklama
useMobileTilesBooleanMobil kutucukların kullanılıp kullanılmayacağı

Return

StaticMap: Zincirleme için bu harita örneği.


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

AdTürAçıklama
weightIntegerÇizgilerin piksel cinsinden genişliği.
colorStringÇizgi rengi, "0xrrggbb" biçiminde bir dize veya Color sabit değeri olarak.
fillColorStringDolgu rengi, "0xrrggbb" biçiminde bir dize veya Color sabit değeri.

Return

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz:


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

AdTürAçıklama
widthIntegerResmin piksel cinsinden genişliği.
heightIntegerResmin piksel cinsinden yüksekliği.

Return

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz:


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

AdTürAçıklama
zoomIntegerSıfır ile 21 arasında (bu değerler dahil) bir değer.

Return

StaticMap: Zincirleme için bu harita örneği.

Aşağıdaki kaynakları da incelemenizi öneririz: