อนุญาตให้สร้างและตกแต่งรูปภาพแผนที่แบบคงที่
ตัวอย่างด้านล่างแสดงวิธีใช้ชั้นเรียนนี้เพื่อสร้างแผนที่ของโรงละครในนิวยอร์กซิตี้ เขต รวมทั้งสถานีรถไฟใกล้เคียง แล้วแสดงในเว็บแอปแบบง่ายๆ
// 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();
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
address | String | ที่อยู่ที่จะเพิ่ม |
รีเทิร์น
StaticMap
— อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่
addMarker(latitude, longitude)
เพิ่มเครื่องหมายลงในแผนที่โดยใช้จุด (ละติจูด/ลองจิจูด)
// Creates a map and adds a marker at the specified coordinates. var map = Maps.newStaticMap().addMarker(40.741799, -74.004207);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
latitude | Number | ละติจูดของเครื่องหมายใหม่ |
longitude | Number | ลองจิจูดของเครื่องหมายใหม่ |
รีเทิร์น
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');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
address | String | ที่อยู่เพื่อวางเครื่องหมายใหม่ |
รีเทิร์น
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]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
points | Number[] | อาร์เรย์ของคู่ละติจูด/ลองจิจูดที่กำหนดเส้นทาง |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
polyline | String | เส้นประกอบที่เข้ารหัส |
รีเทิร์น
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();
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
latitude | Number | ละติจูดของจุด |
longitude | Number | ลองจิจูดของจุด |
รีเทิร์น
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)
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
latitude | Number | ละติจูดของจุด |
longitude | Number | ลองจิจูดของจุด |
รีเทิร์น
StaticMap
— อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่
ดูเพิ่มเติม
addVisible(address)
เพิ่มตำแหน่งที่อยู่ที่ต้องมองเห็นได้ในแผนที่
// Creates a map where New York and Boston are visible. var map = Maps.newStaticMap() .addVisible('New York, NY') .addVisible('Boston, MA');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
address | String | ที่อยู่ที่ต้องปรากฏในแผนที่ |
รีเทิร์น
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 ที่สร้างใหม่อาจมีข้อกำหนดที่เข้มงวดขึ้นชั่วคราว โควต้า
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
contentType | String | ประเภท 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
latitude | Number | ละติจูดของศูนย์กลาง |
longitude | Number | ลองจิจูดของศูนย์กลาง |
รีเทิร์น
StaticMap
— อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่
ดูเพิ่มเติม
setCenter(address)
กำหนดศูนย์กลางของแผนที่โดยใช้ที่อยู่
// Creates a map centered on Times Square, using its address. var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
address | String | ที่อยู่ของศูนย์ |
รีเทิร์น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
imageUrl | String | ระบุ URL เพื่อใช้เป็นไอคอนที่กำหนดเองของเครื่องหมาย รูปภาพต้องเป็นรูปแบบ PNG, JPEG หรือ GIF แต่แนะนำให้ใช้ PNG |
useShadow | Boolean | ระบุว่าเครื่องหมายควรมีเงาที่สร้างขึ้น โดยอิงจากรูปภาพ ความโปร่งแสง/ความโปร่งใสของพื้นที่ที่มองเห็นได้ |
รีเทิร์น
StaticMap
— อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่
ดูเพิ่มเติม
setFormat(format)
setLanguage(language)
ตั้งค่าภาษาที่ใช้สำหรับข้อความบนแผนที่ (เมื่อมี)
// Creates a map with the language set to French. var map = Maps.newStaticMap().setLanguage('fr');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
language | String | ตัวระบุภาษา BCP-47 |
รีเทิร์น
StaticMap
— อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่
ดูเพิ่มเติม
setMapType(mapType)
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');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
size | String | ค่าคงที่จาก MarkerSize |
color | String | สตริงในรูปแบบ "0xrrggbb" หรือค่าคงที่จาก Color |
label | String | สตริงที่มีอักขระเดียวคือ A-Z หรือ 0-9 |
รีเทิร์น
StaticMap
— อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่
ดูเพิ่มเติม
setMobile(useMobileTiles)
ตั้งค่าว่าจะใช้ชุดการ์ดพิเศษสำหรับอุปกรณ์เคลื่อนที่หรือไม่
// Creates a map that uses mobile-friendly tiles. var map = Maps.newStaticMap().setMobile(true);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
useMobileTiles | Boolean | จะใช้หน้าต่างสำหรับมือถือหรือไม่ |
รีเทิร์น
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');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
weight | Integer | ความกว้างของเส้นเป็นพิกเซล |
color | String | สีของเส้นในรูปแบบสตริงในรูปแบบ "0xrrggbb" หรือค่าคงที่จาก
Color |
fillColor | String | สีเติม สตริงในรูปแบบ "0xrrggbb" หรือค่าคงที่จาก
Color |
รีเทิร์น
StaticMap
— อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่
ดูเพิ่มเติม
setSize(width, height)
กำหนดความกว้างและความสูงของภาพแผนที่เป็นพิกเซล
// Creates a map 400px wide by 300px high. var map = Maps.newStaticMap().setSize(400, 300);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
width | Integer | ความกว้างของรูปภาพเป็นพิกเซล |
height | Integer | ความสูงของรูปภาพเป็นพิกเซล |
รีเทิร์น
StaticMap
— อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่
ดูเพิ่มเติม
setZoom(zoom)
ตั้งค่าตัวคูณการซูมหรือระดับการขยายที่ใช้สำหรับแผนที่
// Creates a map with a zoom factor of 10. var map = Maps.newStaticMap().setZoom(10);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
zoom | Integer | ค่าตั้งแต่ 0 ถึง 21 (รวมค่าแรกและค่าสุดท้าย) |
รีเทิร์น
StaticMap
— อินสแตนซ์ของแผนที่นี้สำหรับการทำสายโซ่