Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

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`	Görsel 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 karo 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 (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

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

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

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