ภาพรวมของ 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 Client, ไคลเอ็นต์ Python, Go Client และ Node.js Client สำหรับบริการของ Google Maps เป็นไลบรารีไคลเอ็นต์ที่สนับสนุนชุมชน และเป็นโอเพนซอร์สภายใต้ใบอนุญาต Apache 2.0 ดาวน์โหลดใบรับรองจาก GitHub ซึ่งคุณจะดูคำแนะนำการติดตั้งและโค้ดตัวอย่างได้ด้วย

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