Elevation

ElevationService class

google.maps.ElevationService ชั้นเรียน

กำหนดคลาสบริการที่สื่อสารกับเซิร์ฟเวอร์ของ 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 อินเทอร์เฟซ

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

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

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

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

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

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

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

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

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

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

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

ค่าคงที่ ElevationStatus

google.maps.ElevationStatus ค่าคงที่

สถานะที่ 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	ไม่สามารถประมวลผลคำขอระดับความสูงได้สำเร็จ แต่ไม่ทราบสาเหตุที่แน่ชัดของการประมวลผลไม่สำเร็จ