หน้านี้ได้รับการแปลโดย Cloud Translation API

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

ดูเพิ่มเติม

Google Static Maps API

เมธอด

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

Google Static Maps API

`addMarker(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`	ที่อยู่ที่จะวางเครื่องหมายใหม่

รีเทิร์น

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

ดูเพิ่มเติม

Google Static Maps API

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

Google Static Maps API

`addVisible(address)`

เพิ่มตำแหน่งที่อยู่ซึ่งต้องปรากฏในแผนที่

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

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

Google Static Maps API

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`contentType`	`String`	ประเภท 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);

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

Google Static Maps API

`setCenter(address)`

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

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

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

Google Static Maps API

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

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

Google Static Maps API

`setFormat(format)`

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

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

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

Google Static Maps API

`setLanguage(language)`

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

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

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

การรองรับภาษาใน Google Maps API

`setMapType(mapType)`

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

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

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

Google Static Maps API

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

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

Google Static Maps API

`setMobile(useMobileTiles)`

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

// Creates a map that uses mobile-friendly tiles.
const 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.
const map = Maps.newStaticMap().setPathStyle(
    1,
    Maps.StaticMap.Color.BLACK,
    'red',
);

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

Google Static Maps API

`setSize(width, height)`

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

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

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

Google Static Maps API

`setZoom(zoom)`

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

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

พารามิเตอร์

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

รีเทิร์น

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

ดูเพิ่มเติม

Google Static Maps API