Class StaticMap

StaticMap

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ı nasıl oluşturabileceğiniz ve bunu basit bir web uygulamasında nasıl görüntüleyebileceğiniz 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:

Yöntemler

YöntemDönüş türüKısa açıklama
addAddress(address)StaticMapMevcut yol tanımına yeni bir adres ekler.
addMarker(latitude, longitude)StaticMapBir nokta (lat/lng) 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 çok çizgi kullanarak haritaya yol ekler.
addPoint(latitude, longitude)StaticMapMevcut yol tanımına yeni bir nokta (lat/lng) ekler.
addVisible(latitude, longitude)StaticMapHaritada görünmesi gereken bir nokta (lat/lng) konumu ekler.
addVisible(address)StaticMapHaritada görünmesi 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 temizleyin.
clearVisibles()StaticMapMevcut görünen konum grubunu 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ürme.
getBlob()BlobGörsel verilerini Blob olarak alır.
getMapImage()Byte[]Ham resim verilerini bayt dizisi olarak alır.
getMapUrl()StringHarita resminin URL'sini alır.
setCenter(latitude, longitude)StaticMapHaritanın merkezini bir nokta (lat/lng) kullanarak ayarlar.
setCenter(address)StaticMapBir adres kullanarak haritanın merkezini 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 metin için kullanılacak dili (varsa) 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 kart gruplarının kullanılıp kullanılmayacağını belirler.
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 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

AdTürAçıklama
addressStringEklenecek 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

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

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

Return

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


addPoint(latitude, longitude)

Mevcut yol tanımına yeni bir nokta (lat/lng) 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 (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

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

AdTürAçıklama
addressStringHaritada görünmesi 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 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

AdTürAçıklama
contentTypeStringDö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ümanları için 'text/markdown' de geçerlidir.

Return

Blob: Veriler bir blob olarak.


getBlob()

Görsel 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

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)

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

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

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


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

Return

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

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


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

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

AdTürAçıklama
sizeStringMarkerSize öğesinden sabit bir değer.
colorString"0xrrggbb" biçiminde bir dize veya Color içindeki sabit bir değer.
labelStringA-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:


setMobile(useMobileTiles)

Mobil cihazlar için özel karo 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

AdTürAçıklama
useMobileTilesBooleanMobil 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

AdTürAçıklama
weightIntegerÇizgilerin piksel cinsinden genişliği.
colorString"0xrrggbb" biçiminde bir dize veya Color içindeki sabit bir değer olarak çizgi rengi.
fillColorStringDolgu 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:


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