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