Elevation

ElevationService คลาส

google.maps.ElevationService คลาส

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

เมื่อใช้ v=beta ให้เข้าถึงได้โดยการโทรหา const {ElevationService} = await google.map.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

อินเทอร์เฟซ 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

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

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