Elevation

ElevationService คลาส

google.maps.ElevationService คลาส

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

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

ElevationService
ElevationService()
พารามิเตอร์: ไม่มี
สร้างอินสแตนซ์ใหม่ของ ElevationService ที่ส่งคําค้นหาระดับความสูงไปยังเซิร์ฟเวอร์ของ Google
getElevationAlongPath
getElevationAlongPath(request[, callback])
พารามิเตอร์: 
แสดงผลค่า:  Promise<PathElevationResponse>
สร้างคําขอระดับความสูงระหว่างเส้นทาง ซึ่งส่งคืนข้อมูลระดับความสูงเป็นตัวอย่างที่อิงตามระยะทางตลอดเส้นทางนั้น
getElevationForLocations
getElevationForLocations(request[, callback])
พารามิเตอร์: 
แสดงผลค่า:  Promise<LocationElevationResponse>
ส่งคําขอระดับความสูงสําหรับรายชื่อสถานที่ที่แยกจากกัน

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

อินเทอร์เฟซ 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 ดําเนินการตามคําขอระดับความสูงไม่สําเร็จ แต่ไม่ทราบสาเหตุที่แท้จริงของความล้มเหลว