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