ภาพรวม Elevation API

Elevation API คือบริการที่แสดงผลข้อมูลระดับความสูงสําหรับสถานที่ต่างๆ บนโลก หรือสุ่มตัวอย่างข้อมูลระดับความสูงตลอดเส้นทาง

เหตุผลที่ควรใช้ Elevation API

Elevation API ช่วยให้คุณพัฒนาแอปพลิเคชันเพื่อสนับสนุนลูกค้าด้วยกิจกรรมที่มีความละเอียดอ่อน การวางตําแหน่งแอปพลิเคชัน หรือแอปพลิเคชันที่ทําการสํารวจต่ําซึ่งมีการเปลี่ยนแปลงระดับความสูงและการเปลี่ยนแปลงในเส้นทางต่างๆ ตัวอย่างเช่น คุณให้ข้อมูลความสูงและการสูญเสียเพื่อเพิ่มประสิทธิภาพแอปพลิเคชันกีฬาสําหรับกิจกรรมต่างๆ เช่น เดินป่า ปั่นจักรยาน หรือดําน้ําลึกได้

สิ่งที่คุณทําได้ด้วย Elevation API

Elevation API ให้คุณรวมข้อมูลระดับความสูงในแอปพลิเคชันหรือในแผนที่ได้ ตัวอย่างเช่น

  • ดูระดับความสูงของสถานที่หนึ่ง
  • คํานวณความแตกต่างของระดับความสูงระหว่างเส้นทางหรือระหว่าง 2 จุด

วิธีการทํางานของ Elevation API

Elevation API ยอมรับคําขอเป็น URL ที่เข้ารหัสพร้อมด้วยพิกัดละติจูด/ลองจิจูดที่ให้ไว้เป็นตําแหน่งแยกต่างหาก หรือเป็นชุดตําแหน่งตลอดเส้นทาง ตัวอย่างเช่น คําขอนี้ เช่น การค้นหาระดับความสูงสําหรับใจกลางเมืองเดนเวอร์ รัฐโคโลราโด โดยระบุการคืนสินค้าในรูปแบบ JSON 
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

บริการดึงข้อมูลระดับความสูงสําหรับพิกัดที่ระบุ และยังประมาณระดับความสูงของตําแหน่งที่ไม่มีระดับความสูง ซึ่งแสดงค่าเฉลี่ยจากสถานที่ที่ใกล้เคียงกันที่สุด 4 แห่งซึ่งแสดงข้อมูลระดับความสูง และสุดท้ายคือการกําหนดความละเอียดโดยรวมสําหรับสถานที่นั้นๆ

แหล่งข้อมูล

ตารางต่อไปนี้สรุปทรัพยากรที่พร้อมใช้งานผ่าน Elevation API พร้อมด้วยข้อมูลที่แสดงผล

แหล่งข้อมูล ข้อมูลที่ส่งคืน รูปแบบการคืนสินค้า
พิกัดละติจูดและลองจิจูด

คุณให้บริการข้อมูลในรูปแบบสถานที่อย่างน้อย 1 แห่ง หรือแสดงเป็นชุดตลอดเส้นทางได้ คุณยังระบุพิกัดที่เข้ารหัสได้ด้วย ส่งผ่านพิกัดได้สูงสุด 512 พิกัด

Elevation API มีระดับความสูงเป็นเมตรที่สัมพันธ์กับระดับน้ําทะเลปานกลาง (LMSL) การยกระดับสามารถแสดงผลเป็นค่าบวกหรือค่าลบตามที่ระบุไว้ด้านล่าง

  • ค่าบวกจะระบุตําแหน่งที่สูงกว่า LMSL รวมถึงตําแหน่งพื้นผิวหรือด้านล่างของทะเลสาบสูง
  • ค่าลบจะระบุตําแหน่งที่ต่ํากว่า LMSL ซึ่งรวมถึงตําแหน่งบนพื้นผิวหรือก้นมหาสมุทร
  • ความละเอียด บ่งชี้ระยะทางระหว่างจุดข้อมูลกับระดับความสูงเป็นหน่วยเมตร
  • JSON
  • XML

วิธีใช้ Elevation API

1 ตั้งค่าเลย เริ่มต้นด้วยตั้งค่าโปรเจ็กต์ Google Cloud และทําตามวิธีการตั้งค่าให้เสร็จสมบูรณ์หลังจากนั้น
2 ลองใช้คําขอระดับความสูง เมื่อมีคีย์ API แล้ว คุณจะเริ่มทดสอบ Elevation API ได้โดยตรงจากเบราว์เซอร์ โปรดดูรายละเอียดในตัวอย่างคําขอในคู่มือเริ่มต้นใช้งาน
3 เขียนคําขอที่ซับซ้อนมากขึ้น เมื่อตั้งค่าโปรเจ็กต์แล้ว ให้ลองส่งคําขอที่ระบุข้อมูลตําแหน่งตลอดเส้นทาง โปรดดูรายละเอียดในการระบุเส้นทาง
4 ทําความเข้าใจพื้นฐานการตอบกลับ สํารวจคําตอบเกี่ยวกับข้อมูลระดับความสูงเพื่อเตรียมใช้ข้อมูลระดับความสูงสําหรับแอปของคุณ ดูรายละเอียดได้ที่คําตอบเรื่องระดับความสูง
5 ผสานรวมข้อมูลระดับความสูงในแอปของคุณเอง คุณสามารถใช้ข้อมูลระดับความสูงเพื่อปรับปรุงแอปตามตําแหน่ง เช่น แอปสําหรับกิจกรรมกีฬาหรือสําหรับข้อมูลแบบสํารวจ

ไลบรารีของไคลเอ็นต์ที่พร้อมใช้งาน

เรียก API นี้ในภาษาที่คุณเลือกผ่านไลบรารีของไคลเอ็นต์ต่อไปนี้

ไคลเอ็นต์ Java, ไคลเอ็นต์ Python, Go Client และ Node.js สําหรับ Google Maps บริการเป็นไลบรารีของไคลเอ็นต์ที่รองรับชุมชน ซึ่งเปิดอยู่ภายใต้ใบอนุญาต Apache 2.0 ดาวน์โหลดได้จาก GitHub ซึ่งคุณสามารถดูวิธีการติดตั้งและรหัสตัวอย่าง

ขั้นตอนถัดไป