Class StaticMap

StaticMap

Statik harita resimlerinin oluşturulmasına ve süslenmesine olanak tanır.

Aşağıdaki örnekte, yakındaki tren istasyonları da dahil olmak üzere New York City's Theatre Bölgesi'nin haritasını oluşturmak ve bu haritayı basit bir web uygulamasında görüntülemek için bu sınıfı nasıl kullanabileceğiniz gösterilmektedir.

// 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 Static Maps API

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
addAddress(address)	StaticMap	Mevcut yol tanımına yeni bir adres ekler.
addMarker(latitude, longitude)	StaticMap	Nokta (enlem/lng) kullanarak haritaya işaretleyici ekler.
addMarker(address)	StaticMap	Adres kullanarak haritaya işaretleyici ekler.
addPath(points)	StaticMap	Bir nokta dizisi kullanarak haritaya bir yol ekler.
addPath(polyline)	StaticMap	Kodlanmış bir çoklu çizgi kullanarak haritaya bir yol ekler.
addPoint(latitude, longitude)	StaticMap	Geçerli yol tanımına yeni bir nokta (enlem/boylam) 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 temizleyin.
clearVisibles()	StaticMap	Geçerli görünür konumlar 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 olarak alır.
getMapImage()	Byte[]	Ham görüntü verilerini bayt dizisi olarak alır.
getMapUrl()	String	Harita resminin URL'sini alır.
setCenter(latitude, longitude)	StaticMap	Bir nokta (enlem/lng) kullanarak haritanın merkezini ayarlar.
setCenter(address)	StaticMap	Bir adres kullanarak haritanın merkezini ayarlar.
setCustomMarkerStyle(imageUrl, useShadow)	StaticMap	Yeni işaretçi oluştururken kullanılacak özel işaretçi resmini ayarlar.
setFormat(format)	StaticMap	Harita resminin biçimini ayarlar.
setLanguage(language)	StaticMap	Haritadaki metinler için kullanılacak dili ayarlar (kullanılabilir olduğunda).
setMapType(mapType)	StaticMap	Gösterilecek harita 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 karo gruplarının 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 resminin genişliğini ve yüksekliğini piksel cinsinden ayarlar.
setZoom(zoom)	StaticMap	Haritada kullanılan yakınlaştırma faktörünü veya büyütme düzeyini ayarlar.

Ayrıntılı belgeler

addAddress(address)

Mevcut 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 bir adres.

Return

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

---

addMarker(latitude, longitude)

Nokta (enlem/lng) kullanarak haritaya işaretleyici 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 için bu harita örneği.

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

• Google Static Maps API

---

addMarker(address)

Adres kullanarak haritaya işaretleyici 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çiyi yerleştireceğiniz adres.

Return

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

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

• Google Static Maps API

---

addPath(points)

Bir nokta dizisi kullanarak haritaya bir 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 enlem/boylam çiftleri dizisi.

Return

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

---

addPath(polyline)

Kodlanmış bir çoklu çizgi kullanarak haritaya bir 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 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.
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 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.
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 için bu harita örneği.

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

• Google Static Maps API

---

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

Return

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

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

• Google Static Maps API

---

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.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

Return

StaticMap: Zincirleme için 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 için bu harita örneği.

---

clearPaths()

Mevcut yol grubunu temizleyin.

var 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()

Geçerli görünür konumlar grubunu temizler.

var 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()

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 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ün. Bu yöntem, dosya adına uygun uzantıyı ekler (örneğin, "dosyam.pdf"). Bununla birlikte, dosya adında son noktanın ardından gelen bölümün (varsa) değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "ShoppingList.12.25.2014", "ShoppingList.12.25.pdf" haline gelir.

Günlük dönüşüm kotalarını görüntülemek için Google Hizmetleri Kotalar bölümüne bakın. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkı kotalara tabi olabilir.

Parametreler

Ad	Tür	Açıklama
contentType	String	Dönüştürülecek MIME türü. Çoğu blob için geçerli tek seçenek 'application/pdf''tir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp', 'image/gif', 'image/jpeg' veya 'image/png' değerleri de geçerlidir.

Return

Blob: Blob halinde veriler.

---

getBlob()

Resim verilerini Blob olarak 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 görüntüsü.

---

getMapImage()

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

Genel olarak, diğer hizmetlerle daha kolay etkileşimler kurulmasını sağlayan getBlob() kullanmayı tercih edin.

// 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 görüntüsü.

---

getMapUrl()

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

---

setCenter(latitude, longitude)

Bir nokta (enlem/lng) 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 için bu harita örneği.

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

• Google Static Maps API

---

setCenter(address)

Bir adres kullanarak haritanın merkezini 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 için bu harita örneği.

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

• Google Static Maps API

---

setCustomMarkerStyle(imageUrl, useShadow)

Yeni işaretçi oluştururken kullanılacak özel işaretçi resmini ayarlar. Önceden eklenmiş olan 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()
    .setCustomMarkerStyle('http://www.example.com/marker.png', false);

Parametreler

Ad	Tür	Açıklama
imageUrl	String	İşaretçinin özel simgesi olarak kullanılacak bir URL'yi belirtir. Resimler PNG, JPEG veya GIF biçimlerinde olabilir ancak PNG önerilir.
useShadow	Boolean	İşaretçinin, görüntünün görünür bölgesine ve opaklığına/şeffaflığına bağlı olarak gölge oluşturulması gerektiğini belirtir.

Return

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

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

• Google Static Maps API

---

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 değerinden sabit bir değerdir.

Return

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

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

• Google Static Maps API

---

setLanguage(language)

Haritadaki metinler için kullanılacak dili ayarlar (kullanılabilir 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 için bu harita örneği.

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

• Google Haritalar API'lerinde Dil Desteği

---

setMapType(mapType)

Gösterilecek harita 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 değerinden sabit bir değerdir.

Return

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

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

• Google Static Maps API

---

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 değerinden sabit bir değerdir.
color	String	"0xrrggbb" biçiminde bir dize veya Color değerinde sabit bir değer.
label	String	A-Z veya 0-9 arasındaki tek bir karakteri içeren dize.

Return

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

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

• Google Static Maps API

---

setMobile(useMobileTiles)

Mobil cihazlar için özel karo gruplarının 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 kartların kullanılıp kullanılmayacağı.

Return

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

---

setPathStyle(weight, color, fillColor)

Yeni yollar oluşturulurken kullanılacak yol stilini ayarlar. Önceden eklenmiş olan yollar bu durumdan etkilenmez.

// 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 veya Color değerindeki sabit bir değer olarak çizgi rengi.
fillColor	String	Dolgu rengi, "0xrrggbb" biçiminde bir dize veya Color değerindeki sabit bir değer.

Return

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

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

• Google Static Maps API

---

setSize(width, height)

Harita resminin 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 için bu harita örneği.

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

• Google Static Maps API

---

setZoom(zoom)

Haritada 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.
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 için bu harita örneği.

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

• Google Static Maps API