Class StaticMap

StaticMap

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

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

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

ดูเพิ่มเติม

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addAddress(address)StaticMapเพิ่มที่อยู่ใหม่ลงในคําจํากัดความเส้นทางปัจจุบัน
addMarker(latitude, longitude)StaticMapเพิ่มเครื่องหมายลงในแผนที่โดยใช้จุด (lat/lng)
addMarker(address)StaticMapเพิ่มเครื่องหมายลงในแผนที่โดยใช้ที่อยู่
addPath(points)StaticMapเพิ่มเส้นทางลงในแผนที่โดยใช้อาร์เรย์ของจุด
addPath(polyline)StaticMapเพิ่มเส้นทางลงในแผนที่โดยใช้รูปหลายเหลี่ยมที่เข้ารหัส
addPoint(latitude, longitude)StaticMapเพิ่มจุดใหม่ (lat/lng) ลงในคําจํากัดความเส้นทางปัจจุบัน
addVisible(latitude, longitude)StaticMapเพิ่มตำแหน่งจุด (lat/lng) ที่ต้องแสดงในแผนที่
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กำหนดศูนย์กลางของแผนที่โดยใช้จุด (lat/lng)
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. const map = Maps.newStaticMap()                 .beginPath()                 .addAddress('New York, NY')                 .addAddress('Boston, MA')                 .endPath();

พารามิเตอร์

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

รีเทิร์น

StaticMap — อินสแตนซ์แผนที่นี้สําหรับการต่อเชื่อม


addMarker(latitude, longitude)

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

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

พารามิเตอร์

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

รีเทิร์น

StaticMap — อินสแตนซ์แผนที่นี้สําหรับการต่อเชื่อม

ดูเพิ่มเติม


addMarker(address)

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

// Creates a map and adds a marker at the specified address. const 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. const 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. const polyline = Maps.encodePolyline([   40.714353,   -74.005973,   42.358431,   -71.059773, ]); const map = Maps.newStaticMap().addPath(polyline);

พารามิเตอร์

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

รีเทิร์น

StaticMap — อินสแตนซ์แผนที่นี้สําหรับการต่อเชื่อม


addPoint(latitude, longitude)

เพิ่มจุดใหม่ (lat/lng) ลงในคําจํากัดความเส้นทางปัจจุบัน

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

พารามิเตอร์

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

รีเทิร์น

StaticMap — อินสแตนซ์แผนที่นี้สําหรับการต่อเชื่อม


addVisible(latitude, longitude)

เพิ่มตำแหน่งจุด (lat/lng) ที่ต้องแสดงในแผนที่

// Creates a map where New York and Boston are visible. const 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. const 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. const map = Maps.newStaticMap()                 .beginPath()                 .addAddress('New York, NY')                 .addAddress('Boston, MA')                 .endPath();

รีเทิร์น

StaticMap — อินสแตนซ์แผนที่นี้สําหรับการต่อเชื่อม


clearMarkers()

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

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

รีเทิร์น

StaticMap — อินสแตนซ์แผนที่นี้สําหรับการต่อเชื่อม


clearPaths()

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

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

รีเทิร์น

StaticMap — อินสแตนซ์แผนที่นี้สําหรับการต่อเชื่อม


clearVisibles()

ล้างชุดสถานที่ที่มองเห็นได้ในปัจจุบัน

const 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. const 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' ก็ได้ สำหรับเอกสาร Google เอกสาร จะใช้ 'text/markdown' ก็ได้เช่นกัน

รีเทิร์น

Blob — ข้อมูลเป็น Blob


getBlob()

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

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

รีเทิร์น

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


getMapImage()

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

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

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

รีเทิร์น

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


getMapUrl()

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

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

รีเทิร์น

String — URL URL รูปภาพแผนที่


setCenter(latitude, longitude)

กำหนดศูนย์กลางของแผนที่โดยใช้จุด (lat/lng)

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

พารามิเตอร์

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

รีเทิร์น

StaticMap — อินสแตนซ์แผนที่นี้สําหรับการต่อเชื่อม

ดูเพิ่มเติม


setCenter(address)

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

// Creates a map centered on Times Square, using its address. const 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". const 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. const map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

พารามิเตอร์

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

รีเทิร์น

StaticMap — อินสแตนซ์แผนที่นี้สําหรับการต่อเชื่อม

ดูเพิ่มเติม


setLanguage(language)

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

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

พารามิเตอร์

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

รีเทิร์น

StaticMap — อินสแตนซ์แผนที่นี้สําหรับการต่อเชื่อม

ดูเพิ่มเติม


setMapType(mapType)

ตั้งค่าประเภทแผนที่ที่จะแสดง

// Creates a satellite map. const 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". const 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. const 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. const 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. const map = Maps.newStaticMap().setSize(400, 300);

พารามิเตอร์

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

รีเทิร์น

StaticMap — อินสแตนซ์แผนที่นี้สําหรับการต่อเชื่อม

ดูเพิ่มเติม


setZoom(zoom)

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

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

พารามิเตอร์

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

รีเทิร์น

StaticMap — อินสแตนซ์แผนที่นี้สําหรับการต่อเชื่อม

ดูเพิ่มเติม