Elevation

ElevationService class

google.maps.ElevationService class

กำหนดคลาสบริการที่สื่อสารกับเซิร์ฟเวอร์ของ Google โดยตรงเพื่อขอข้อมูลระดับความสูง

เข้าถึงโดยการโทรหา const {ElevationService} = await google.maps.importLibrary("elevation") โปรดดูไลบรารีใน Maps JavaScript API

ผู้ผลิต
ElevationService	ElevationService() พารามิเตอร์: ไม่มี สร้างอินสแตนซ์ใหม่ของ ElevationService ที่ส่งการค้นหาระดับความสูงไปยังเซิร์ฟเวอร์ของ Google

เมธอด
getElevationAlongPath	getElevationAlongPath(request[, callback]) พารามิเตอร์:  request:  PathElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional ผลลัพธ์:  Promise<PathElevationResponse> ส่งคําขอระดับความสูงตามเส้นทาง ซึ่งระบบจะแสดงผลข้อมูลระดับความสูงเป็นตัวอย่างตามระยะทางตลอดเส้นทางนั้น
getElevationForLocations	getElevationForLocations(request[, callback]) พารามิเตอร์:  request:  LocationElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional ผลลัพธ์:  Promise<LocationElevationResponse> ส่งคําขอระดับความสูงสําหรับรายการสถานที่ตั้งแบบแยกต่างหาก

LocationElevationRequest interface

google.maps.LocationElevationRequest อินเทอร์เฟซ

คำขอระดับความสูงที่ส่งโดย ElevationService ซึ่งมีรายการพิกัดแบบไม่ต่อเนื่อง (LatLng) สำหรับแสดงผลข้อมูลระดับความสูง

พร็อพเพอร์ตี้
locations optional	ประเภท:  Array<LatLng|LatLngLiteral> optional ตำแหน่งแบบไม่ต่อเนื่องที่จะดึงข้อมูลระดับความสูง

อินเทอร์เฟซ LocationElevationResponse

google.maps.LocationElevationResponse อินเทอร์เฟซ

การตอบกลับระดับความสูงที่ ElevationService แสดงผลซึ่งมีรายการ ElevationResult ที่ตรงกับสถานที่ตั้งของ LocationElevationRequest

พร็อพเพอร์ตี้
results	ประเภท:  Array<ElevationResult> รายการ ElevationResult ที่ตรงกับสถานที่ตั้งของ LocationElevationRequest

PathElevationRequest interface

google.maps.PathElevationRequest อินเทอร์เฟซ

การค้นหาระดับความสูงที่ส่งโดย ElevationService ซึ่งมีเส้นทางที่จะแสดงข้อมูลตัวอย่าง คำขอนี้จะกำหนดเส้นทางต่อเนื่องบนพื้นโลกซึ่งควรทำการสุ่มตัวอย่างระดับความสูงในระยะห่างเท่าๆ กัน เส้นทางทั้งหมดจากจุดยอดหนึ่งไปยังอีกจุดยอดหนึ่งใช้ส่วนของเส้นรอบโลกระหว่างจุด 2 จุดนั้น

พร็อพเพอร์ตี้
samples	ประเภท:  number ต้องระบุ จำนวนจุดที่เท่ากันตลอดเส้นทางที่ระบุเพื่อดึงข้อมูลระดับความสูง รวมถึงจุดสิ้นสุด จํานวนตัวอย่างต้องเป็นค่าระหว่าง 2 ถึง 512
path optional	ประเภท:  Array<LatLng|LatLngLiteral> optional เส้นทางที่จะใช้รวบรวมค่าระดับความสูง

PathElevationResponse interface

google.maps.PathElevationResponse อินเทอร์เฟซ

การตอบกลับระดับความสูงที่ ElevationService แสดงเป็นรายการ ElevationResult ที่เว้นระยะเท่าๆ กันตลอดเส้นทางของ PathElevationRequest

พร็อพเพอร์ตี้
results	ประเภท:  Array<ElevationResult> รายการ ElevationResult ที่ตรงกับตัวอย่างของ PathElevationRequest

ElevationResult interface

google.maps.ElevationResult อินเทอร์เฟซ

ผลลัพธ์ของคําขอ ElevationService ซึ่งประกอบด้วยชุดพิกัดระดับความสูงและค่าระดับความสูง โปรดทราบว่าคําขอเดียวอาจสร้าง ElevationResult หลายรายการ

พร็อพเพอร์ตี้
elevation	ประเภท:  number ระดับความสูงของจุดนี้บนโลกเป็นเมตรเหนือระดับน้ำทะเล
resolution	ประเภท:  number ระยะทางเป็นเมตรระหว่างจุดตัวอย่างที่ใช้หาค่าระดับความสูง พร็อพเพอร์ตี้นี้จะหายไปหากไม่ทราบวิธีแก้ปัญหา โปรดทราบว่าข้อมูลระดับความสูงจะมีความคร่าวมากขึ้น (ค่า resolution มีค่ามากขึ้น) เมื่อผ่านจุดหลายจุด หากต้องการค่าความสูงที่แม่นยำที่สุดสำหรับจุดหนึ่งๆ คุณควรค้นหาจุดนั้นแยกต่างหาก
location optional	ประเภท:  LatLng optional ตำแหน่งของผลลัพธ์ระดับความสูงนี้

ElevationStatus constants

google.maps.ElevationStatus constants

สถานะที่ ElevationService แสดงเมื่อคำขอการเลื่อนระดับเสร็จสมบูรณ์ ระบุค่าเหล่านี้ตามค่า หรือใช้ชื่อของค่าคงที่ เช่น 'OK' หรือ google.maps.ElevationStatus.OK

เข้าถึงโดยการโทรหา const {ElevationStatus} = await google.maps.importLibrary("elevation") โปรดดูไลบรารีใน Maps JavaScript API

ค่าคงที่
INVALID_REQUEST	คำขอไม่ถูกต้อง
OK	คำขอไม่พบข้อผิดพลาดใดๆ
OVER_QUERY_LIMIT	หน้าเว็บมีคำขอเกินขีดจำกัดในช่วงเวลาสั้นๆ
REQUEST_DENIED	หน้าเว็บไม่ได้รับอนุญาตให้ใช้บริการระดับความสูง
UNKNOWN_ERROR	ดำเนินการตามคำขอการเลื่อนระดับไม่สำเร็จ แต่ไม่ทราบสาเหตุที่แน่ชัด