Class StaticMap

StaticMap

Statik harita görüntülerinin oluşturulmasına ve süslenmesine olanak tanır.

Aşağıdaki örnekte, New York City's Theatre'ın haritasını oluşturmak için bu sınıfı nasıl kullanabileceğiniz gösterilmektedir Bölge bilgilerini, yakındaki tren istasyonlarını içeren ve basit bir web uygulamasında görüntüler.

// 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";

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

• Google Statik Haritalar API'si

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
addAddress(address)	StaticMap	Geçerli yol tanımına yeni bir adres ekler.
addMarker(latitude, longitude)	StaticMap	Nokta (Enl/Boyl) kullanarak haritaya bir işaretçi ekler.
addMarker(address)	StaticMap	Adres kullanarak haritaya bir işaretçi ekler.
addPath(points)	StaticMap	Nokta dizisini kullanarak haritaya yol ekler.
addPath(polyline)	StaticMap	Kodlanmış bir çoklu çizgi kullanarak haritaya yol ekler.
addPoint(latitude, longitude)	StaticMap	Geçerli yol tanımına yeni bir nokta (enlem/lng) ekler.
addVisible(latitude, longitude)	StaticMap	Haritada görünmesi gereken bir nokta (enlem/boylam) konumu ekler.
addVisible(address)	StaticMap	Haritada görünmesi gereken bir adres konumu ekler.
beginPath()	StaticMap	Yeni bir yol tanımı başlatır.
clearMarkers()	StaticMap	Geçerli işaretçi grubunu temizler.
clearPaths()	StaticMap	Mevcut yol grubunu temizle.
clearVisibles()	StaticMap	Mevcut görünür konum grubunu temizler.
endPath()	StaticMap	StartPath() ile başlayan bir yol tanımını tamamlar.
getAs(contentType)	Blob	Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün.
getBlob()	Blob	Resim verilerini Blob biçiminde alır.
getMapImage()	Byte[]	Ham görüntü verilerini bayt dizisi olarak alır.
getMapUrl()	String	Harita görüntüsünün URL'sini alır.
setCenter(latitude, longitude)	StaticMap	Bir nokta (enlem/boylam) kullanarak haritanın merkezini ayarlar.
setCenter(address)	StaticMap	Haritanın merkezini adres kullanarak ayarlar.
setCustomMarkerStyle(imageUrl, useShadow)	StaticMap	Yeni işaretçiler oluştururken kullanılacak özel işaretçi resmini ayarlar.
setFormat(format)	StaticMap	Harita resminin biçimini ayarlar.
setLanguage(language)	StaticMap	Haritadaki metin için kullanılacak dili ayarlar (mevcut olduğunda).
setMapType(mapType)	StaticMap	Gösterilecek haritanın türünü ayarlar.
setMarkerStyle(size, color, label)	StaticMap	Yeni işaretçiler oluştururken kullanılacak işaretçi stilini ayarlar.
setMobile(useMobileTiles)	StaticMap	Mobil cihazlar için özel kart grupları kullanılıp kullanılmayacağını ayarlar.
setPathStyle(weight, color, fillColor)	StaticMap	Yeni yollar oluşturulurken kullanılacak yol stilini ayarlar.
setSize(width, height)	StaticMap	Harita görüntüsünün genişliğini ve yüksekliğini piksel cinsinden ayarlar.
setZoom(zoom)	StaticMap	Harita için kullanılan yakınlaştırma faktörünü veya büyütme seviyesini 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.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

Parametreler

Ad	Tür	Açıklama
address	String	Eklenecek adres.

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

---

addMarker(latitude, longitude)

Nokta (Enl/Boyl) kullanarak haritaya bir işaretçi ekler.

// Creates a map and adds a marker at the specified coordinates.
var 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

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Statik Haritalar API'si

---

addMarker(address)

Adres kullanarak haritaya bir işaretçi ekler.

// Creates a map and adds a marker at the specified address.
var 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

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Statik Haritalar API'si

---

addPath(points)

Nokta dizisini kullanarak haritaya yol ekler.

// 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]);

Parametreler

Ad	Tür	Açıklama
points	Number[]	Yolu tanımlayan bir enlem/boylam çiftleri dizisi.

Return

StaticMap: Zincirleme amaçlı 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.
var polyline = Maps.encodePolyline([40.714353, -74.005973, 42.358431, -71.059773]);
var map = Maps.newStaticMap().addPath(polyline);

Parametreler

Ad	Tür	Açıklama
polyline	String	Kodlanmış bir çoklu çizgi.

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

---

addPoint(latitude, longitude)

Geçerli yol tanımına yeni bir nokta (enlem/lng) ekler.

// 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();

Parametreler

Ad	Tür	Açıklama
latitude	Number	Noktanın enlemi.
longitude	Number	Noktanın boylamı.

Return

StaticMap: Zincirleme amaçlı 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.
var 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

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Statik Haritalar API'si

---

addVisible(address)

Haritada görünmesi gereken bir adres konumu ekler.

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible('New York, NY')
    .addVisible('Boston, MA');

Parametreler

Ad	Tür	Açıklama
address	String	Haritada görünmesi gereken bir adrestir.

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Statik Haritalar API'si

---

beginPath()

Yeni bir yol tanımı başlatır. addAddress() ve addPoint() çağrılarının her birini tanımlar bir tepe noktası oluşturalım. endPath() çağrıldığında yol tamamlanır.

// 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: Zincirleme amaçlı bu harita örneği.

---

clearMarkers()

Geçerli işaretçi grubunu temizler.

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

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

---

clearPaths()

Mevcut yol grubunu temizle.

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

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

---

clearVisibles()

Mevcut görünür konum grubunu temizler.

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all visible locations created with addVisible().
map.clearVisibles();

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

---

endPath()

StartPath() ile başlayan bir yol tanımını tamamlar.

// 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: Zincirleme amaçlı 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ün. Bu yöntemi, dosya adına uygun uzantıyı ekler. Örneğin, "dosyam.pdf". Ancak, dosya adında son noktadan sonra gelen bölümün (varsa) mevcut bir alan olduğunu varsayar değiştirilmesi gereken uzantıdır. Sonuç olarak, "AlışverişListesi.12.25.2014" şu olur: "ShoppingList.12.25.pdf".

Günlük dönüşüm kotalarını görüntülemek için bkz. Google için Kotalar Hizmetler. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkılığa tabi olabilir kotalar.

Parametreler

Ad	Tür	Açıklama
contentType	String	Dönüşümün gerçekleştirileceği MIME türü. Çoğu blob için 'application/pdf', tek geçerli seçenektir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp', 'image/gif', 'image/jpeg' veya 'image/png''ten herhangi biri de geçerlidir. Bir Google Dokümanlar dokümanı için 'text/markdown' ayrıca geçerlidir.

Return

Blob — Veriler bir blob olarak.

---

getBlob()

Resim verilerini Blob biçiminde alır.

// 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 — Haritanın seçilen resim biçimindeki bir resmi.

---

getMapImage()

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

Genel olarak, diğerleriyle daha basit etkileşimlere olanak tanıyan getBlob() kullanmayı tercih edin kullanıma sunuyoruz.

// 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[] — Haritanın seçilen resim biçimindeki bir resmi.

---

getMapUrl()

Harita görüntüsünün URL'sini alır.

// 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 Harita resmi URL'si.

---

setCenter(latitude, longitude)

Bir nokta (enlem/boylam) kullanarak haritanın merkezini ayarlar.

// Creates a map centered on Times Square, using its coordinates.
var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

Parametreler

Ad	Tür	Açıklama
latitude	Number	Merkezin enlemi.
longitude	Number	Merkezin boylamı.

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Statik Haritalar API'si

---

setCenter(address)

Haritanın merkezini adres kullanarak ayarlar.

// Creates a map centered on Times Square, using its address.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');

Parametreler

Ad	Tür	Açıklama
address	String	Merkezin adresi.

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Statik Haritalar API'si

---

setCustomMarkerStyle(imageUrl, useShadow)

Yeni işaretçiler oluştururken kullanılacak özel işaretçi resmini ayarlar. İşaretçiler etkilenmez.

// 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);

Parametreler

Ad	Tür	Açıklama
imageUrl	String	İşaretçinin özel simgesi olarak kullanılacak URL'yi belirtir. Resimler PNG, JPEG biçiminde olabilir veya GIF biçimlerinde de kullanabilirsiniz.
useShadow	Boolean	Resmin değerine bağlı olarak, işaretçide bir gölge oluşturulması gerektiğini belirtir ve opaklığını/şeffaflığını gösterir.

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Statik Haritalar API'si

---

setFormat(format)

Harita resminin biçimini ayarlar.

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

Parametreler

Ad	Tür	Açıklama
format	String	Format öğesinden sabit bir değer.

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Statik Haritalar API'si

---

setLanguage(language)

Haritadaki metin için kullanılacak dili ayarlar (mevcut olduğunda).

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

Parametreler

Ad	Tür	Açıklama
language	String	BCP-47 dil tanımlayıcısı.

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Haritalar API'lerinde Dil Desteği

---

setMapType(mapType)

Gösterilecek haritanın türünü ayarlar.

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

Parametreler

Ad	Tür	Açıklama
mapType	String	Type öğesinden sabit bir değer.

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Statik Haritalar API'si

---

setMarkerStyle(size, color, label)

Yeni işaretçiler oluştururken kullanılacak işaretçi stilini ayarlar. Önceden eklenmiş işaretçiler etkilenmez.

// 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');

Parametreler

Ad	Tür	Açıklama
size	String	MarkerSize öğesinden sabit bir değer.
color	String	"0xrrggbb" biçiminde bir dize veya Color'den sabit bir değer alır.
label	String	A'dan Z'ye veya 0-9'a kadar tek bir karakter içeren bir dize.

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Statik Haritalar API'si

---

setMobile(useMobileTiles)

Mobil cihazlar için özel kart grupları kullanılıp kullanılmayacağını ayarlar.

// Creates a map that uses mobile-friendly tiles.
var map = Maps.newStaticMap().setMobile(true);

Parametreler

Ad	Tür	Açıklama
useMobileTiles	Boolean	Mobil karoların kullanılıp kullanılmayacağı.

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

---

setPathStyle(weight, color, fillColor)

Yeni yollar oluşturulurken kullanılacak yol stilini ayarlar. Zaten eklenmiş olan yollar yardımcı olabilir.

// 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');

Parametreler

Ad	Tür	Açıklama
weight	Integer	Çizgilerin piksel cinsinden genişliği.
color	String	"0xrrggbb" biçiminde bir dize olarak çizgi rengi veya Color
fillColor	String	Dolgu rengi, "0xrrggbb" biçiminde bir dize veya Color

Return

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Statik Haritalar API'si

---

setSize(width, height)

Harita görüntüsünün genişliğini ve yüksekliğini piksel cinsinden ayarlar.

// Creates a map 400px wide by 300px high.
var 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

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Statik Haritalar API'si

---

setZoom(zoom)

Harita için kullanılan yakınlaştırma faktörünü veya büyütme seviyesini ayarlar.

// Creates a map with a zoom factor of 10.
var 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

StaticMap: Zincirleme amaçlı bu harita örneği.

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

• Google Statik Haritalar API'si