Class StaticMap

StatikHarita

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

Aşağıdaki örnekte, bu sınıfı kullanarak New York City'nin Tiyatro Bölgesi'nin (yakındaki tren istasyonları dahil) haritasını oluşturma ve bunu basit bir web uygulamasında görüntüleme işlemleri gösterilmektedir.

// 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:

• 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	Bir nokta (lat/lng) kullanarak haritaya işaretçi ekler.
addMarker(address)	StaticMap	Adres kullanarak haritaya işaretçi ekler.
addPath(points)	StaticMap	Bir nokta dizisi kullanarak haritaya yol ekler.
addPath(polyline)	StaticMap	Kodlanmış bir çok çizgi kullanarak haritaya yol ekler.
addPoint(latitude, longitude)	StaticMap	Mevcut yol tanımına yeni bir nokta (lat/lng) ekler.
addVisible(latitude, longitude)	StaticMap	Haritada görünmesi gereken bir nokta (lat/lng) 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	Mevcut işaretçi grubunu temizler.
clearPaths()	StaticMap	Mevcut yol grubunu temizleyin.
clearVisibles()	StaticMap	Mevcut görünen konum grubunu temizler.
endPath()	StaticMap	beginPath() ile başlatılan 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ürme.
getBlob()	Blob	Resim verilerini Blob olarak alır.
getMapImage()	Byte[]	Ham resim verilerini bayt dizisi olarak alır.
getMapUrl()	String	Harita resminin URL'sini alır.
setCenter(latitude, longitude)	StaticMap	Haritanın merkezini bir nokta (lat/lng) kullanarak ayarlar.
setCenter(address)	StaticMap	Bir adres kullanarak haritanın merkezini 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 (varsa) ayarlar.
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 kart gruplarının kullanılıp kullanılmayacağını belirler.
setPathStyle(weight, color, fillColor)	StaticMap	Yeni yollar oluştururken kullanılacak yol stilini ayarlar.
setSize(width, height)	StaticMap	Harita resminin 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ı dokümanlar

addAddress(address)

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

Return

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

---

addMarker(latitude, longitude)

Bir nokta (lat/lng) 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

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

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 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 bir enlem/boylam çifti dizisi.

Return

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

---

addPath(polyline)

Kodlanmış bir çok ç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

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

---

addPoint(latitude, longitude)

Mevcut 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

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

---

addVisible(latitude, longitude)

Haritada görünmesi gereken bir nokta (lat/lng) 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

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.
const 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 köşeyi 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 temizleyin.

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

Mevcut görünen konum grubunu 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ürme. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktayı (varsa) izleyen kısmının, değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "AlışverişListesi.25.12.2014", "AlışverişListesi.25.12.pdf" olur.

Dönüşümler için günlük kotaları görüntülemek istiyorsanız Google Hizmetleri için 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
contentType	String	Dönüştürülecek 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' değerlerinden herhangi biri de geçerlidir. Google Dokümanlar dokümanı için 'text/markdown' de geçerlidir.

Return

Blob: Veriler bir 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: Seçilen resim biçiminde haritanın resmi.

---

getMapImage()

Ham resim verilerini bayt dizisi olarak alır.

Genel olarak, diğer hizmetlerle daha basit etkileşimlere olanak tanıyan getBlob() kullanmayı tercih edin.

// 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[]: Seçilen resim biçiminde haritanın resmi.

---

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

---

setCenter(latitude, longitude)

Haritanın merkezini bir nokta (lat/lng) 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

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.
const 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çiler oluştururken kullanılacak özel işaretçi resmini ayarlar. Daha önce eklenen işaretçiler bu değişiklikten 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
imageUrl	String	İşaretçinin özel simgesi olarak kullanılacak URL'yi belirtir. Resimler PNG, JPEG veya GIF biçiminde olabilir ancak PNG önerilir.
useShadow	Boolean	İşaretçinin, görüntünün görünen bölgesine ve opaklığına/şeffaflığına göre 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.
const 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 için bu harita örneği.

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

• Google Static Maps API

---

setLanguage(language)

Haritadaki metin için kullanılacak dili (varsa) 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

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.
const 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 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. Daha önce eklenen işaretçiler bu durumdan 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	MarkerSize öğesinden sabit bir değer.
color	String	"0xrrggbb" biçiminde bir dize veya Color içindeki sabit bir değer.
label	String	A-Z veya 0-9 arasında tek bir karakter içeren bir 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 kart gruplarının kullanılıp kullanılmayacağını belirler.

// Creates a map that uses mobile-friendly tiles.
const 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ştururken kullanılacak yol stilini ayarlar. Daha önce eklenen yollar bu durumdan 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	"0xrrggbb" biçiminde bir dize veya Color içindeki sabit bir değer olarak çizgi rengi.
fillColor	String	Dolgu rengi, "0xrrggbb" biçiminde bir dize veya Color içindeki 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.
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

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

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

• Google Static Maps API

---

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

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

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

• Google Static Maps API