Class Maps

Maps

อนุญาตให้ค้นหาเส้นทาง แปลงพิกัดภูมิศาสตร์ สุ่มตัวอย่างระดับความสูง และสร้างรูปภาพแผนที่แบบคงที่

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
DirectionFinder	DirectionFinderEnums
StaticMap	StaticMapEnums

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
decodePolyline(polyline)	Number[]	ถอดรหัสสตริง Polyline ที่เข้ารหัสกลับเป็นอาร์เรย์ของจุด
encodePolyline(points)	String	เข้ารหัสอาร์เรย์ของจุดเป็นสตริง
newDirectionFinder()	DirectionFinder	สร้างออบเจ็กต์ DirectionFinder ใหม่
newElevationSampler()	ElevationSampler	สร้างออบเจ็กต์ ElevationSampler
newGeocoder()	Geocoder	สร้างออบเจ็กต์ Geocoder ใหม่
newStaticMap()	StaticMap	สร้างออบเจ็กต์ StaticMap ใหม่
resetAuthenticationApiKey()	void	รีเซ็ตข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์เพื่อใช้โควต้าเริ่มต้น
setAuthenticationByApiKey(apiKey)	void	เปิดใช้การใช้คีย์ API เพื่อตรวจสอบสิทธิ์คำขอเพื่อใช้ประโยชน์จากโควต้าเพิ่มเติม
setAuthenticationByApiKey(apiKey, signingKey)	void	เปิดใช้คีย์ API และคีย์การลงนามเพื่อตรวจสอบสิทธิ์คำขอเพื่อใช้ประโยชน์จากโควต้าเพิ่มเติมใน StaticMap

วิธีการที่เลิกใช้งานแล้ว

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
setAuthentication(clientId, signingKey)	void	ช่วยให้ใช้บัญชี Google Maps APIs Premium Plan ที่สร้างขึ้นภายนอกได้ เพื่อใช้โควต้า เพิ่มเติม

เอกสารโดยละเอียด

decodePolyline(polyline)

ถอดรหัสสตริง Polyline ที่เข้ารหัสกลับเป็นอาร์เรย์ของจุด

// Decodes a string representation of the latitudes and longitudes of
// Minneapolis and Milwaukee respectively.
const polyline = 'qvkpG`qhxPbgyI_zq_@';
const points = Maps.decodePolyline(polyline);
for (let i = 0; i < points.length; i += 2) {
  Logger.log('%s, %s', points[i], points[i + 1]);
}

พารามิเตอร์

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

รีเทิร์น

Number[] — อาร์เรย์ของคู่ละติจูด ลองจิจูด (lat0, long0, lat1, long1, ...)

ดูเพิ่มเติม

• รูปแบบ Polyline ที่เข้ารหัส

---

encodePolyline(points)

เข้ารหัสอาร์เรย์ของจุดเป็นสตริง

// The latitudes and longitudes of New York and Boston respectively.
const points = [40.77, -73.97, 42.34, -71.04];
const polyline = Maps.encodePolyline(points);

พารามิเตอร์

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

รีเทิร์น

String — สตริงที่เข้ารหัสซึ่งแสดงจุดเหล่านั้น

ดูเพิ่มเติม

• รูปแบบ Polyline ที่เข้ารหัส

---

newDirectionFinder()

สร้างออบเจ็กต์ DirectionFinder ใหม่

รีเทิร์น

DirectionFinder — ออบเจ็กต์เครื่องมือค้นหาเส้นทางใหม่

---

newElevationSampler()

สร้างออบเจ็กต์ ElevationSampler

รีเทิร์น

ElevationSampler - ออบเจ็กต์เครื่องมือสุ่มตัวอย่างระดับความสูงใหม่

---

newGeocoder()

สร้างออบเจ็กต์ Geocoder ใหม่

รีเทิร์น

Geocoder — ออบเจ็กต์ Geocoder ใหม่

---

newStaticMap()

สร้างออบเจ็กต์ StaticMap ใหม่

รีเทิร์น

StaticMap — ออบเจ็กต์แผนที่แบบคงที่ใหม่

---

resetAuthenticationApiKey()

รีเซ็ตข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์เพื่อใช้โควต้าเริ่มต้น เมธอดนี้ใช้ได้ เมื่อคุณใช้คีย์ API เพื่อตรวจสอบสิทธิ์คำขอ คุณสามารถใช้วิธีนี้เพื่อเปลี่ยนกลับไปใช้ โควต้าเริ่มต้นได้หากต้องการใช้Mapsโดยไม่ต้องระบุ ข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์

Maps.resetAuthenticationApiKey();

ส่ง

Error — หากใช้ setAuthentication(clientId, signingKey) ในการตรวจสอบสิทธิ์

---

setAuthenticationByApiKey(apiKey)

เปิดใช้การใช้คีย์ API เพื่อตรวจสอบสิทธิ์คำขอเพื่อใช้ประโยชน์จากโควต้าเพิ่มเติม

เมธอดนี้ใช้เพื่อตั้งค่าคีย์ API ซึ่งใช้เพื่อตรวจสอบสิทธิ์คำขอ เมื่อเรียกใช้เมธอดนี้ ระบบจะเรียกเก็บเงินและการใช้โควต้าจากโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ที่เชื่อมโยงกับคีย์ API ที่ระบุตามตารางราคา คุณสามารถ ใช้วิธีการ Maps โดยมีโควต้าเริ่มต้นได้โดยไม่ต้องระบุ ข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์ หากคุณใช้ StaticMap โปรดใช้วิธี setAuthenticationByApiKey(apiKey, signingKey) แทน

หมายเหตุ: หากคุณใช้รหัสไคลเอ็นต์เพื่อตรวจสอบสิทธิ์คำขอ โปรดทราบว่าเราเลิกใช้งานรหัสไคลเอ็นต์ตั้งแต่วันที่ 26 พฤษภาคม 2025 และจะใช้ไม่ได้อีกต่อไปหลังจากวันที่ 31 พฤษภาคม 2026 คุณต้องใช้ข้อมูลเข้าสู่ระบบคีย์ API เพื่อตรวจสอบสิทธิ์การเข้าชมบริการ Google Maps API แทนการใช้รหัสไคลเอ็นต์ ดูรายละเอียดเพิ่มเติมได้ที่คู่มือ

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
apiKey	String	คีย์ API ซึ่งรับได้จาก คอนโซล Google Cloud โดยทำตามขั้นตอน ที่ระบุไว้ในคู่มือเริ่มใช้งานฉบับย่อ

ส่ง

Error — หาก apiKey เป็น null หรือหากมีการใช้ setAuthentication(clientId, signingKey) สำหรับการตรวจสอบสิทธิ์อยู่แล้ว

---

setAuthenticationByApiKey(apiKey, signingKey)

เปิดใช้คีย์ API และคีย์การลงนามเพื่อตรวจสอบสิทธิ์คำขอเพื่อใช้ประโยชน์จากโควต้าเพิ่มเติมใน StaticMap แม้ว่า signingKey จะจำเป็นสำหรับคำขอไปยัง Static Map API แต่วิธีนี้ก็ใช้เพื่อตรวจสอบสิทธิ์บริการอื่นๆ ของ Maps ได้เช่นกัน ในกรณีดังกล่าว ระบบจะไม่สนใจพารามิเตอร์ signingKey

เมธอดนี้ใช้เพื่อตั้งค่าคีย์ API และคีย์ Signing ซึ่งใช้เพื่อตรวจสอบสิทธิ์คำขอ StaticMap ต้องใช้คีย์การลงนาม โดยจะยอมรับคำขอจำนวนเล็กน้อยที่ไม่มีลายเซ็นเพื่อวัตถุประสงค์ในการทดสอบ แต่คำขอเหล่านั้นจะเริ่มล้มเหลวเมื่อถึงเกณฑ์ในเวอร์ชันที่ใช้งานจริง อ่านรายละเอียดเพิ่มเติมได้ที่นี่

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0',
'7_pry-Skg0PKxds-7nvdl91mB5=');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
apiKey	String	คีย์ API ซึ่งรับได้จาก คอนโซล Google Cloud โดยทำตามขั้นตอน ที่ระบุไว้ในคู่มือเริ่มใช้งานฉบับย่อ
signingKey	String	คีย์การลงนามซึ่งรับได้จากคอนโซล Google Cloud โดยทำตามขั้นตอนที่ระบุไว้ในคู่มือ สำหรับลายเซ็นดิจิทัล ต้องระบุสำหรับ StaticMap และระบบจะละเว้นสำหรับบริการ Maps อื่นๆ

ส่ง

Error — หาก apiKey เป็น null หรือหากมีการใช้ setAuthentication(clientId, signingKey) สำหรับการตรวจสอบสิทธิ์อยู่แล้ว

ดูเพิ่มเติม

• setAuthenticationByApiKey(apiKey)

วิธีการที่เลิกใช้งานแล้ว

setAuthentication(clientId, signingKey)

เลิกใช้งานแล้ว แต่ให้ใช้ setAuthenticationByApiKey(apiKey) ซึ่งใช้คีย์ API สำหรับ การตรวจสอบสิทธิ์แทน

ช่วยให้ใช้บัญชี Google Maps APIs Premium Plan ที่สร้างขึ้นภายนอกได้ เพื่อใช้โควต้า เพิ่มเติม คุณจะดูรหัสไคลเอ็นต์และคีย์การลงนามได้จากส่วน Maps ของคอนโซล Google Cloud ตั้งค่าเหล่านี้เป็น null เพื่อกลับไปใช้โควต้าเริ่มต้น

หมายเหตุ: วิธีนี้ใช้กับคีย์ API ไม่ได้ นอกจากนี้ โปรดทราบว่าแพ็กเกจ Premium จะไม่มีให้บริการสำหรับลูกค้าใหม่อีกต่อไป หากยังไม่มีใบอนุญาตแพ็กเกจพรีเมียม โปรดอย่าโทรหา setAuthentication(clientId, signingKey) คุณสามารถใช้Mapsเมธอดที่มีโควต้าเริ่มต้น

ได้

Maps.setAuthentication('gme-123456789', 'VhSEZvOXVSdnlxTnpJcUE');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
clientId	String	ตัวระบุไคลเอ็นต์
signingKey	String	คีย์การลงชื่อส่วนตัว

ส่ง

Error — หากมีการใช้ setAuthenticationByApiKey(apiKey) สำหรับ การตรวจสอบสิทธิ์อยู่แล้ว