อนุญาตให้สร้างและตกแต่งรูปภาพแผนที่แบบคงที่
ตัวอย่างด้านล่างแสดงวิธีใช้คลาสนี้เพื่อสร้างแผนที่ย่านโรงละครของนครนิวยอร์ก ซึ่งรวมถึงสถานีรถไฟที่อยู่ใกล้เคียง และแสดงในเว็บแอปแบบง่าย
// 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`;
ดูเพิ่มเติม
เมธอด
| วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
|---|---|---|
add | Static | เพิ่มที่อยู่ใหม่ลงในการกําหนดเส้นทางปัจจุบัน |
add | Static | เพิ่มเครื่องหมายลงในแผนที่โดยใช้จุด (ละติจูด/ลองจิจูด) |
add | Static | เพิ่มเครื่องหมายลงในแผนที่โดยใช้ที่อยู่ |
add | Static | เพิ่มเส้นทางลงในแผนที่โดยใช้อาร์เรย์ของจุด |
add | Static | เพิ่มเส้นทางลงในแผนที่โดยใช้ Polyline ที่เข้ารหัส |
add | Static | เพิ่มจุดใหม่ (ละติจูด/ลองจิจูด) ลงในคำจำกัดความเส้นทางปัจจุบัน |
add | Static | เพิ่มตำแหน่งจุด (ละติจูด/ลองจิจูด) ที่ต้องแสดงในแผนที่ |
add | Static | เพิ่มตำแหน่งที่อยู่ซึ่งต้องแสดงในแผนที่ |
begin | Static | เริ่มคำจำกัดความเส้นทางใหม่ |
clear | Static | ล้างชุดเครื่องหมายปัจจุบัน |
clear | Static | ล้างชุดเส้นทางปัจจุบัน |
clear | Static | ล้างชุดตำแหน่งที่มองเห็นได้ในปัจจุบัน |
end | Static | สิ้นสุดการกําหนดเส้นทางที่เริ่มต้นด้วย beginPath() |
get | Blob | แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น Blob ที่แปลงเป็นประเภทเนื้อหาที่ระบุ |
get | Blob | รับข้อมูลรูปภาพเป็น Blob |
get | Byte[] | รับข้อมูลรูปภาพดิบเป็นอาร์เรย์ไบต์ |
get | String | รับ URL ของรูปภาพแผนที่ |
set | Static | กำหนดศูนย์กลางของแผนที่โดยใช้จุด (lat/lng) |
set | Static | กำหนดศูนย์กลางของแผนที่โดยใช้ที่อยู่ |
set | Static | กำหนดรูปภาพเครื่องหมายที่กำหนดเองที่จะใช้เมื่อสร้างเครื่องหมายใหม่ |
set | Static | ตั้งค่ารูปแบบของรูปภาพแผนที่ |
set | Static | ตั้งค่าภาษาที่จะใช้สำหรับข้อความบนแผนที่ (หากมี) |
set | Static | ตั้งค่าประเภทแผนที่ที่จะแสดง |
set | Static | กำหนดรูปแบบเครื่องหมายที่จะใช้เมื่อสร้างเครื่องหมายใหม่ |
set | Static | กำหนดว่าจะใช้ชุดไทล์เฉพาะสำหรับอุปกรณ์เคลื่อนที่หรือไม่ |
set | Static | กำหนดรูปแบบเส้นทางที่จะใช้เมื่อสร้างเส้นทางใหม่ |
set | Static | กำหนดความกว้างและความสูงของรูปภาพแผนที่เป็นพิกเซล |
set | Static | กำหนดปัจจัยการซูมหรือระดับการขยายที่ใช้สำหรับแผนที่ |
เอกสารโดยละเอียด
add Address(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();
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
address | String | ที่อยู่ที่ต้องการเพิ่ม |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
add Marker(latitude, longitude)
เพิ่มเครื่องหมายลงในแผนที่โดยใช้จุด (ละติจูด/ลองจิจูด)
// Creates a map and adds a marker at the specified coordinates. const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
latitude | Number | ละติจูดของเครื่องหมายใหม่ |
longitude | Number | ลองจิจูดของเครื่องหมายใหม่ |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
ดูเพิ่มเติม
add Marker(address)
เพิ่มเครื่องหมายลงในแผนที่โดยใช้ที่อยู่
// Creates a map and adds a marker at the specified address. const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
address | String | ที่อยู่ที่ต้องการวางเครื่องหมายใหม่ |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
ดูเพิ่มเติม
add Path(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, ]);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
points | Number[] | อาร์เรย์ของคู่ละติจูด/ลองจิจูดที่กำหนดเส้นทาง |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
add Path(polyline)
เพิ่มเส้นทางลงในแผนที่โดยใช้ 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);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
polyline | String | เส้นประกอบที่เข้ารหัส |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
add Point(latitude, longitude)
เพิ่มจุดใหม่ (ละติจูด/ลองจิจูด) ลงในคำจำกัดความเส้นทางปัจจุบัน
// 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();
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
latitude | Number | ละติจูดของจุด |
longitude | Number | ลองจิจูดของจุด |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
add Visible(latitude, longitude)
เพิ่มตำแหน่งจุด (ละติจูด/ลองจิจูด) ที่ต้องแสดงในแผนที่
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap() .addVisible(40.714353, -74.005973) .addVisible(42.358431, -71.059773);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
latitude | Number | ละติจูดของจุด |
longitude | Number | ลองจิจูดของจุด |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
ดูเพิ่มเติม
add Visible(address)
เพิ่มตำแหน่งที่อยู่ซึ่งต้องแสดงในแผนที่
// Creates a map where New York and Boston are visible. const map = Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
address | String | ที่อยู่ที่ต้องมองเห็นได้ในแผนที่ |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
ดูเพิ่มเติม
begin Path()
เริ่มคำจำกัดความเส้นทางใหม่ การเรียกใช้ add และ add จะกำหนดจุดยอดใหม่แต่ละจุดในเส้นทาง เส้นทางจะเสร็จสมบูรณ์เมื่อมีการเรียกใช้ end
// 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();
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
clear Markers()
ล้างชุดเครื่องหมายปัจจุบัน
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all markers on the map. map.clearMarkers();
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
clear Paths()
ล้างชุดเส้นทางปัจจุบัน
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all paths on the map. map.clearPaths();
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
clear Visibles()
ล้างชุดตำแหน่งที่มองเห็นได้ในปัจจุบัน
const map = Maps.newStaticMap(); // ... // Do something interesting here ... // ... // Remove all visible locations created with addVisible(). map.clearVisibles();
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
end Path()
สิ้นสุดการกําหนดเส้นทางที่เริ่มต้นด้วย 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();
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
get As(contentType)
แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น Blob ที่แปลงเป็นประเภทเนื้อหาที่ระบุ วิธีนี้จะเพิ่มนามสกุลที่เหมาะสมให้กับชื่อไฟล์ เช่น "myfile.pdf" อย่างไรก็ตาม ระบบจะ ถือว่าส่วนของชื่อไฟล์ที่อยู่หลังจุดสุดท้าย (หากมี) เป็นนามสกุลที่มีอยู่ ซึ่งควรแทนที่ ดังนั้น "ShoppingList.12.25.2014" จะกลายเป็น "ShoppingList.12.25.pdf"
หากต้องการดูโควต้า Conversion รายวัน โปรดดูโควต้าสำหรับบริการของ Google โดเมน Google Workspace ที่สร้างขึ้นใหม่จะอยู่ภายใต้โควต้าที่เข้มงวดกว่าชั่วคราว
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
content | String | ประเภท MIME ที่จะแปลง สำหรับ Blob ส่วนใหญ่ 'application/pdf' เป็น
ตัวเลือกเดียวที่ใช้ได้ สำหรับรูปภาพในรูปแบบ BMP, GIF, JPEG หรือ PNG คุณยังใช้ 'image/bmp', 'image/gif', 'image/jpeg' หรือ 'image/png' ได้ด้วย
เช่นกัน สำหรับเอกสาร Google เอกสาร 'text/markdown' ก็ใช้ได้เช่นกัน |
รีเทิร์น
Blob — ข้อมูลเป็น Blob
get Blob()
รับข้อมูลรูปภาพเป็น 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 — รูปภาพของแผนที่ในรูปแบบรูปภาพที่เลือก
get Map Image()
รับข้อมูลรูปภาพดิบเป็นอาร์เรย์ไบต์
โดยทั่วไปแล้ว เราขอแนะนำให้ใช้ get ซึ่งช่วยให้โต้ตอบกับบริการอื่นๆ ได้ง่ายขึ้น
// 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[] - รูปภาพของแผนที่ในรูปแบบรูปภาพที่เลือก
get Map Url()
รับ 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 ของรูปภาพแผนที่
set Center(latitude, longitude)
กำหนดศูนย์กลางของแผนที่โดยใช้จุด (lat/lng)
// Creates a map centered on Times Square, using its coordinates. const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
latitude | Number | ละติจูดของศูนย์กลาง |
longitude | Number | ลองจิจูดของศูนย์กลาง |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
ดูเพิ่มเติม
set Center(address)
กำหนดศูนย์กลางของแผนที่โดยใช้ที่อยู่
// Creates a map centered on Times Square, using its address. const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
address | String | ที่อยู่ของศูนย์ |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
ดูเพิ่มเติม
set Custom Marker Style(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, );
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
image | String | ระบุ URL ที่จะใช้เป็นไอคอนที่กำหนดเองของเครื่องหมาย รูปภาพอาจอยู่ในรูปแบบ PNG, JPEG หรือ GIF แต่เราขอแนะนำให้ใช้ PNG |
use | Boolean | ระบุว่าเครื่องหมายควรมีเงาที่สร้างขึ้นตามภูมิภาคที่มองเห็นได้ของรูปภาพและความทึบแสง/ความโปร่งใส |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
ดูเพิ่มเติม
set Format(format)
set Language(language)
ตั้งค่าภาษาที่จะใช้สำหรับข้อความบนแผนที่ (หากมี)
// Creates a map with the language set to French. const map = Maps.newStaticMap().setLanguage('fr');
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
language | String | ตัวระบุภาษา BCP-47 |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
ดูเพิ่มเติม
set Map Type(mapType)
set Marker Style(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', );
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
size | String | ค่าคงที่จาก Marker |
color | String | สตริงในรูปแบบ "0xrrggbb" หรือค่าคงที่จาก Color |
label | String | สตริงที่มีอักขระตัวเดียว A-Z หรือ 0-9 |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
ดูเพิ่มเติม
set Mobile(useMobileTiles)
กำหนดว่าจะใช้ชุดไทล์เฉพาะสำหรับอุปกรณ์เคลื่อนที่หรือไม่
// Creates a map that uses mobile-friendly tiles. const map = Maps.newStaticMap().setMobile(true);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
use | Boolean | จะใช้การ์ดบนอุปกรณ์เคลื่อนที่หรือไม่ |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
set Path Style(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', );
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
weight | Integer | ความกว้างของเส้นในหน่วยพิกเซล |
color | String | สีเส้นเป็นสตริงในรูปแบบ "0xrrggbb" หรือค่าคงที่จาก
Color |
fill | String | สีเติม ซึ่งเป็นสตริงในรูปแบบ "0xrrggbb" หรือค่าคงที่จาก
Color |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
ดูเพิ่มเติม
set Size(width, height)
กำหนดความกว้างและความสูงของรูปภาพแผนที่เป็นพิกเซล
// Creates a map 400px wide by 300px high. const map = Maps.newStaticMap().setSize(400, 300);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
width | Integer | ความกว้างของรูปภาพในหน่วยพิกเซล |
height | Integer | ความสูงของรูปภาพในหน่วยพิกเซล |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง
ดูเพิ่มเติม
set Zoom(zoom)
กำหนดปัจจัยการซูมหรือระดับการขยายที่ใช้สำหรับแผนที่
// Creates a map with a zoom factor of 10. const map = Maps.newStaticMap().setZoom(10);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
zoom | Integer | ค่าตั้งแต่ 0 ถึง 21 |
รีเทิร์น
Static — อินสแตนซ์ของแผนที่นี้สำหรับการเชื่อมโยง