Elevation

คลาส ElevationService

google.maps.ElevationService คลาส
ไลบรารี "elevation"

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

const {ElevationService} = await google.maps.importLibrary("elevation");
ElevationService
ElevationService()
พารามิเตอร์: ไม่มี
สร้างอินสแตนซ์ใหม่ของ ElevationService ที่ส่งคำค้นหาเกี่ยวกับระดับความสูงไปยังเซิร์ฟเวอร์ของ Google
getElevationAlongPath
getElevationAlongPath(request[, callback])
พารามิเตอร์
ค่าที่แสดงผล: Promise<PathElevationResponse>
ส่งคำขอระดับความสูงตามเส้นทาง โดยระบบจะแสดงผลข้อมูลระดับความสูงเป็นตัวอย่างตามระยะทางของเส้นทางนั้น
getElevationForLocations
getElevationForLocations(request[, callback])
พารามิเตอร์
ค่าที่แสดงผล: Promise<LocationElevationResponse>
ส่งคำขอระดับความสูงสำหรับรายการสถานที่ตั้งที่แยกกัน

LocationElevationRequest interface

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

คำขอระดับความสูงที่ส่งโดย ElevationService ซึ่งมีรายการพิกัดแยกกัน (LatLng) ที่จะแสดงข้อมูลระดับความสูง
locations
ไม่บังคับ
ประเภท: Array<LatLng|LatLngLiteral> optional
สถานที่ตั้งแบบไม่ต่อเนื่องที่จะดึงข้อมูลระดับความสูง

LocationElevationResponse interface

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

การตอบกลับระดับความสูงที่แสดงผลโดย ElevationService ซึ่งมีรายการ ElevationResult ที่ตรงกับตำแหน่งของ LocationElevationRequest
results
ประเภท: Array<ElevationResult>
รายการ ElevationResult ที่ตรงกับสถานที่ตั้งของ LocationElevationRequest

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

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

คำค้นหาเกี่ยวกับระดับความสูงที่ส่งโดย ElevationService ซึ่งมีเส้นทางที่จะแสดงข้อมูลจากการสุ่มตัวอย่าง คำขอนี้กำหนดเส้นทางต่อเนื่องตามแนวโลกซึ่งควรเก็บตัวอย่างระดับความสูงในระยะห่างที่เท่ากัน เส้นทางทั้งหมดจากจุดยอดหนึ่งไปยังอีกจุดยอดหนึ่งจะใช้ส่วนของวงกลมใหญ่ระหว่างจุด 2 จุดนั้น
samples
ประเภท: number
ต้องระบุ จำนวนจุดที่ห่างเท่ากันตามเส้นทางที่กำหนดซึ่งจะดึงข้อมูลระดับความสูง รวมถึงจุดสิ้นสุด จำนวนตัวอย่างต้องเป็นค่าระหว่าง 2 ถึง 512 (รวม)
path
ไม่บังคับ
ประเภท: 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
ไม่บังคับ
ประเภท: LatLng optional
ตำแหน่งของผลลัพธ์ระดับความสูงนี้

ค่าคงที่ ElevationStatus

google.maps.ElevationStatus ค่าคงที่
ไลบรารี "elevation"

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

ค่าคงที่เหล่านี้ยังใช้เป็นสตริงได้ด้วย ใน TypeScript สตริงลิเทอรัลจะกำหนดโดยประเภท ElevationStatusString

const {ElevationStatus} = await google.maps.importLibrary("elevation");
INVALID_REQUEST คำขอไม่ถูกต้อง
OK คำขอไม่พบข้อผิดพลาดใดๆ
OVER_QUERY_LIMIT หน้าเว็บมีคำขอเกินขีดจำกัดในช่วงเวลาที่สั้นเกินไป
REQUEST_DENIED หน้าเว็บไม่ได้รับอนุญาตให้ใช้บริการระดับความสูง
UNKNOWN_ERROR ระบบไม่สามารถประมวลผลคำขอการยกระดับได้สำเร็จ แต่ไม่ทราบสาเหตุที่แน่ชัดของความล้มเหลว