Class StaticMap

StaticMap

อนุญาตให้สร้างและตกแต่งรูปภาพแผนที่แบบคงที่

ตัวอย่างด้านล่างแสดงวิธีใช้ชั้นเรียนนี้เพื่อสร้างแผนที่ของโรงละครในนิวยอร์กซิตี้ เขต รวมทั้งสถานีรถไฟใกล้เคียง แล้วแสดงในเว็บแอปแบบง่ายๆ

// 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";

ดูเพิ่มเติม

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addAddress(address)StaticMapเพิ่มที่อยู่ใหม่ลงในการกำหนดเส้นทางปัจจุบัน
addMarker(latitude, longitude)StaticMapเพิ่มเครื่องหมายลงในแผนที่โดยใช้จุด (ละติจูด/ลองจิจูด)
addMarker(address)StaticMapเพิ่มเครื่องหมายลงในแผนที่โดยใช้ที่อยู่
addPath(points)StaticMapเพิ่มเส้นทางลงในแผนที่โดยใช้อาร์เรย์ของจุด
addPath(polyline)StaticMapเพิ่มเส้นทางลงในแผนที่โดยใช้เส้นประกอบที่เข้ารหัส
addPoint(latitude, longitude)StaticMapเพิ่มจุดใหม่ (ละติจูด/ลองจิจูด) ไปยังการกำหนดเส้นทางปัจจุบัน
addVisible(latitude, longitude)StaticMapเพิ่มตำแหน่งจุด (ละติจูด/ลองจิจูด) ที่ต้องมองเห็นได้ในแผนที่
addVisible(address)StaticMapเพิ่มตำแหน่งที่อยู่ที่ต้องมองเห็นได้ในแผนที่
beginPath()StaticMapเริ่มกำหนดเส้นทางใหม่
clearMarkers()StaticMapล้างตัวทำเครื่องหมายชุดปัจจุบัน
clearPaths()StaticMapล้างชุดเส้นทางปัจจุบัน
clearVisibles()StaticMapล้างชุดตำแหน่งที่มองเห็นได้ปัจจุบัน
endPath()StaticMapดำเนินการตามการกำหนดเส้นทางที่เริ่มต้นด้วย beginPath()
getAs(contentType)Blobแสดงข้อมูลภายในออบเจ็กต์นี้เป็น BLOB ที่แปลงเป็นประเภทเนื้อหาที่ระบุ
getBlob()Blobรับข้อมูลรูปภาพเป็น Blob
getMapImage()Byte[]รับข้อมูลรูปภาพดิบเป็นอาร์เรย์ไบต์
getMapUrl()Stringรับ URL ของรูปภาพแผนที่
setCenter(latitude, longitude)StaticMapตั้งค่าศูนย์กลางของแผนที่โดยใช้จุด (ละติจูด/ลองจิจูด)
setCenter(address)StaticMapกำหนดศูนย์กลางของแผนที่โดยใช้ที่อยู่
setCustomMarkerStyle(imageUrl, useShadow)StaticMapตั้งค่าภาพเครื่องหมายที่กำหนดเองเพื่อใช้เมื่อสร้างเครื่องหมายใหม่
setFormat(format)StaticMapตั้งค่ารูปแบบของภาพแผนที่
setLanguage(language)StaticMapตั้งค่าภาษาที่ใช้สำหรับข้อความบนแผนที่ (เมื่อมี)
setMapType(mapType)StaticMapกำหนดประเภทแผนที่ที่จะแสดง
setMarkerStyle(size, color, label)StaticMapกำหนดรูปแบบเครื่องหมายที่จะใช้เมื่อสร้างเครื่องหมายใหม่
setMobile(useMobileTiles)StaticMapตั้งค่าว่าจะใช้ชุดการ์ดพิเศษสำหรับอุปกรณ์เคลื่อนที่หรือไม่
setPathStyle(weight, color, fillColor)StaticMapตั้งค่ารูปแบบเส้นทางที่จะใช้เมื่อสร้างเส้นทางใหม่
setSize(width, height)StaticMapกำหนดความกว้างและความสูงของภาพแผนที่เป็นพิกเซล
setZoom(zoom)StaticMapตั้งค่าตัวคูณการซูมหรือระดับการขยายที่ใช้สำหรับแผนที่

เอกสารโดยละเอียด

addAddress(address)

เพิ่มที่อยู่ใหม่ลงในการกำหนดเส้นทางปัจจุบัน

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
addressStringที่อยู่ที่จะเพิ่ม

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่


addMarker(latitude, longitude)

เพิ่มเครื่องหมายลงในแผนที่โดยใช้จุด (ละติจูด/ลองจิจูด)

// Creates a map and adds a marker at the specified coordinates.
var map = Maps.newStaticMap().addMarker(40.741799, -74.004207);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
latitudeNumberละติจูดของเครื่องหมายใหม่
longitudeNumberลองจิจูดของเครื่องหมายใหม่

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม


addMarker(address)

เพิ่มเครื่องหมายลงในแผนที่โดยใช้ที่อยู่

// Creates a map and adds a marker at the specified address.
var map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
addressStringที่อยู่เพื่อวางเครื่องหมายใหม่

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม


addPath(points)

เพิ่มเส้นทางลงในแผนที่โดยใช้อาร์เรย์ของจุด

// 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]);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
pointsNumber[]อาร์เรย์ของคู่ละติจูด/ลองจิจูดที่กำหนดเส้นทาง

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่


addPath(polyline)

เพิ่มเส้นทางลงในแผนที่โดยใช้เส้นประกอบที่เข้ารหัส

// 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
polylineStringเส้นประกอบที่เข้ารหัส

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่


addPoint(latitude, longitude)

เพิ่มจุดใหม่ (ละติจูด/ลองจิจูด) ไปยังการกำหนดเส้นทางปัจจุบัน

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
latitudeNumberละติจูดของจุด
longitudeNumberลองจิจูดของจุด

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่


addVisible(latitude, longitude)

เพิ่มตำแหน่งจุด (ละติจูด/ลองจิจูด) ที่ต้องมองเห็นได้ในแผนที่

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible(40.714353, -74.005973);
    .addVisible(42.358431, -71.059773)

พารามิเตอร์

ชื่อประเภทคำอธิบาย
latitudeNumberละติจูดของจุด
longitudeNumberลองจิจูดของจุด

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม


addVisible(address)

เพิ่มตำแหน่งที่อยู่ที่ต้องมองเห็นได้ในแผนที่

// Creates a map where New York and Boston are visible.
var map = Maps.newStaticMap()
    .addVisible('New York, NY')
    .addVisible('Boston, MA');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
addressStringที่อยู่ที่ต้องปรากฏในแผนที่

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม


beginPath()

เริ่มกำหนดเส้นทางใหม่ การเรียกไปยัง addAddress() และ addPoint() จะกำหนดแต่ละรายการ จุดยอดใหม่ในเส้นทาง เส้นทางจะเสร็จสมบูรณ์เมื่อมีการเรียกใช้ endPath()

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

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่


clearMarkers()

ล้างตัวทำเครื่องหมายชุดปัจจุบัน

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all markers on the map.
map.clearMarkers();

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่


clearPaths()

ล้างชุดเส้นทางปัจจุบัน

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all paths on the map.
map.clearPaths();

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่


clearVisibles()

ล้างชุดตำแหน่งที่มองเห็นได้ปัจจุบัน

var map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all visible locations created with addVisible().
map.clearVisibles();

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่


endPath()

ดำเนินการตามการกำหนดเส้นทางที่เริ่มต้นด้วย beginPath()

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

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่


getAs(contentType)

แสดงข้อมูลภายในออบเจ็กต์นี้เป็น BLOB ที่แปลงเป็นประเภทเนื้อหาที่ระบุ ช่วงเวลานี้ จะเพิ่มนามสกุลที่เหมาะสมลงในชื่อไฟล์ เช่น "myfile.pdf" อย่างไรก็ตาม จะถือว่าส่วนของชื่อไฟล์ที่อยู่หลังเครื่องหมายจุดสุดท้าย (ถ้ามี) เป็นส่วนที่มีอยู่ ที่ควรแทนที่ ดังนั้น "ShoppingList.12.25.2014" กลายเป็น "ShoppingList.12.25.pdf"

หากต้องการดูโควต้ารายวันสำหรับ Conversion โปรดดูโควต้าสำหรับ Google บริการ โดเมน Google Workspace ที่สร้างใหม่อาจมีข้อกำหนดที่เข้มงวดขึ้นชั่วคราว โควต้า

พารามิเตอร์

ชื่อประเภทคำอธิบาย
contentTypeStringประเภท MIME ที่จะแปลง สำหรับ BLOB ส่วนใหญ่ 'application/pdf' คือ เป็นตัวเลือกเดียวที่ใช้ได้ สำหรับรูปภาพในรูปแบบ BMP, GIF, JPEG หรือ PNG ระบบจะใช้ 'image/bmp', 'image/gif', 'image/jpeg' หรือ 'image/png' ด้วย ใช้ได้ ใช้ 'text/markdown' สำหรับเอกสารของ Google เอกสารได้ด้วย

รีเทิร์น

Blob — ข้อมูลในรูปแบบ BLOB


getBlob()

รับข้อมูลรูปภาพเป็น Blob

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

รีเทิร์น

Blob — รูปภาพแผนที่ในรูปแบบรูปภาพที่เลือก


getMapImage()

รับข้อมูลรูปภาพดิบเป็นอาร์เรย์ไบต์

โดยทั่วไป ชอบใช้ getBlob() ซึ่งช่วยให้โต้ตอบกับคนอื่นได้ง่ายขึ้น บริการต่างๆ

// 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'));

รีเทิร์น

Byte[] — รูปภาพแผนที่ในรูปแบบรูปภาพที่เลือก


getMapUrl()

รับ URL ของรูปภาพแผนที่

// 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");

รีเทิร์น

String — URL URL ของภาพแผนที่


setCenter(latitude, longitude)

ตั้งค่าศูนย์กลางของแผนที่โดยใช้จุด (ละติจูด/ลองจิจูด)

// Creates a map centered on Times Square, using its coordinates.
var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
latitudeNumberละติจูดของศูนย์กลาง
longitudeNumberลองจิจูดของศูนย์กลาง

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม


setCenter(address)

กำหนดศูนย์กลางของแผนที่โดยใช้ที่อยู่

// Creates a map centered on Times Square, using its address.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
addressStringที่อยู่ของศูนย์

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม


setCustomMarkerStyle(imageUrl, useShadow)

ตั้งค่าภาพเครื่องหมายที่กำหนดเองเพื่อใช้เมื่อสร้างเครื่องหมายใหม่ เครื่องหมายที่ ที่เพิ่มเข้ามาจะไม่ได้รับผลกระทบ

// 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
imageUrlStringระบุ URL เพื่อใช้เป็นไอคอนที่กำหนดเองของเครื่องหมาย รูปภาพต้องเป็นรูปแบบ PNG, JPEG หรือ GIF แต่แนะนำให้ใช้ PNG
useShadowBooleanระบุว่าเครื่องหมายควรมีเงาที่สร้างขึ้น โดยอิงจากรูปภาพ ความโปร่งแสง/ความโปร่งใสของพื้นที่ที่มองเห็นได้

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม


setFormat(format)

ตั้งค่ารูปแบบของภาพแผนที่

// Creates a map with the image format set to PNG.
var map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
formatStringค่าคงที่จาก Format

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม


setLanguage(language)

ตั้งค่าภาษาที่ใช้สำหรับข้อความบนแผนที่ (เมื่อมี)

// Creates a map with the language set to French.
var map = Maps.newStaticMap().setLanguage('fr');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
languageStringตัวระบุภาษา BCP-47

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม


setMapType(mapType)

กำหนดประเภทแผนที่ที่จะแสดง

// Creates a satellite map.
var map = Maps.newStaticMap().setMapType(Maps.StaticMap.Type.SATELLITE);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
mapTypeStringค่าคงที่จาก Type

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม


setMarkerStyle(size, color, label)

กำหนดรูปแบบเครื่องหมายที่จะใช้เมื่อสร้างเครื่องหมายใหม่ เครื่องหมายที่เพิ่มไว้แล้ว ไม่ได้รับผลกระทบ

// 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');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
sizeStringค่าคงที่จาก MarkerSize
colorStringสตริงในรูปแบบ "0xrrggbb" หรือค่าคงที่จาก Color
labelStringสตริงที่มีอักขระเดียวคือ A-Z หรือ 0-9

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม


setMobile(useMobileTiles)

ตั้งค่าว่าจะใช้ชุดการ์ดพิเศษสำหรับอุปกรณ์เคลื่อนที่หรือไม่

// Creates a map that uses mobile-friendly tiles.
var map = Maps.newStaticMap().setMobile(true);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
useMobileTilesBooleanจะใช้หน้าต่างสำหรับมือถือหรือไม่

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่


setPathStyle(weight, color, fillColor)

ตั้งค่ารูปแบบเส้นทางที่จะใช้เมื่อสร้างเส้นทางใหม่ เส้นทางที่เพิ่มไว้แล้วไม่ใช่ ที่ได้รับผลกระทบ

// 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');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
weightIntegerความกว้างของเส้นเป็นพิกเซล
colorStringสีของเส้นในรูปแบบสตริงในรูปแบบ "0xrrggbb" หรือค่าคงที่จาก Color
fillColorStringสีเติม สตริงในรูปแบบ "0xrrggbb" หรือค่าคงที่จาก Color

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม


setSize(width, height)

กำหนดความกว้างและความสูงของภาพแผนที่เป็นพิกเซล

// Creates a map 400px wide by 300px high.
var map = Maps.newStaticMap().setSize(400, 300);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
widthIntegerความกว้างของรูปภาพเป็นพิกเซล
heightIntegerความสูงของรูปภาพเป็นพิกเซล

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม


setZoom(zoom)

ตั้งค่าตัวคูณการซูมหรือระดับการขยายที่ใช้สำหรับแผนที่

// Creates a map with a zoom factor of 10.
var map = Maps.newStaticMap().setZoom(10);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
zoomIntegerค่าตั้งแต่ 0 ถึง 21 (รวมค่าแรกและค่าสุดท้าย)

รีเทิร์น

StaticMap — อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่

ดูเพิ่มเติม