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

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่

วิธีการ

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
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();

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
latitude	Number	ละติจูดของเครื่องหมายใหม่
longitude	Number	ลองจิจูดของเครื่องหมายใหม่

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่

---

addMarker(address)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
address	String	ที่อยู่ที่จะวางเครื่องหมายใหม่

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่

---

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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();

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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)

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
latitude	Number	ละติจูดของจุด
longitude	Number	ลองจิจูดของจุด

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่

---

addVisible(address)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
address	String	ที่อยู่ที่ต้องมองเห็นได้ในแผนที่

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่

---

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 ที่สร้างใหม่อาจอยู่ภายใต้โควต้าที่เข้มงวดเป็นการชั่วคราว

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
contentType	String	ประเภท MIME ที่จะแปลงเป็น สำหรับ Blob ส่วนใหญ่ 'application/pdf' เป็นตัวเลือกเดียวที่ใช้ได้ สำหรับรูปภาพในรูปแบบ BMP, GIF, JPEG หรือ PNG คุณสามารถใช้ 'image/bmp', 'image/gif', 'image/jpeg' หรือ 'image/png' ได้เช่นกัน

รีเทิร์น

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
latitude	Number	ละติจูดของจุดศูนย์กลาง
longitude	Number	ลองจิจูดของจุดศูนย์กลาง

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่

---

setCenter(address)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
address	String	ที่อยู่ของศูนย์บริการ

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่

---

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

พารามิเตอร์

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

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่

---

setFormat(format)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
format	String	ค่าคงที่จาก Format

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่

---

setLanguage(language)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
language	String	ตัวระบุภาษา BCP-47

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• ภาษาที่รองรับใน Google Maps API

---

setMapType(mapType)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
mapType	String	ค่าคงที่จาก Type

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่

---

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

พารามิเตอร์

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

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่

---

setMobile(useMobileTiles)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
weight	Integer	ความกว้างของเส้นเป็นพิกเซล
color	String	สีของเส้นเป็นสตริงในรูปแบบ "0xrrggbb" หรือค่าคงที่จาก Color
fillColor	String	สีเติม ซึ่งเป็นสตริงในรูปแบบ "0xrrggbb" หรือค่าคงที่จาก Color

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่

---

setSize(width, height)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
width	Integer	ความกว้างของรูปภาพเป็นพิกเซล
height	Integer	ความสูงของรูปภาพเป็นพิกเซล

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่

---

setZoom(zoom)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
zoom	Integer	รวมค่าตั้งแต่ 0 ถึง 21

รีเทิร์น

StaticMap — อินสแตนซ์แมปนี้สำหรับการทำเชน

ดูเพิ่มเติม

• Google แผนที่ API แบบคงที่