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