ภาพรวม Geolocation API

Geolocation API เป็นบริการที่ยอมรับคำขอ HTTPS ที่มี เสาสัญญาณโทรศัพท์และจุดเข้าใช้งาน Wi-Fi ที่ไคลเอ็นต์บนอุปกรณ์เคลื่อนที่ตรวจพบ โดยจะแสดงพิกัดละติจูด/ลองจิจูดและรัศมีที่บ่งบอกถึงความแม่นยำของ ผลลัพธ์สำหรับอินพุตที่ถูกต้องแต่ละรายการ

เหตุใดจึงต้องใช้ Geolocation API

ใช้ Geolocation API เพื่อระบุตำแหน่งอุปกรณ์เคลื่อนที่ที่ไม่มีฟีเจอร์ตำแหน่งทางภูมิศาสตร์ดั้งเดิม

สิ่งที่ทำได้ด้วย Geolocation API

Geolocation API ช่วยให้คุณใช้ข้อมูลเชิงพื้นที่จากเสาสัญญาณมือถือ และโหนด Wi-Fi เพื่อรับตำแหน่งของอุปกรณ์ที่ไม่มีตำแหน่งทางภูมิศาสตร์หรือ GPS ในตัวได้

วิธีการทำงานของ Geolocation API

Geolocation API ใช้ฟิลด์ข้อมูลอุปกรณ์เคลื่อนที่ ข้อมูลเสาสัญญาณมือถือ และข้อมูลอาร์เรย์จุดเข้าใช้งาน Wi-Fi เพื่อแสดงผลพิกัดละติจูด/ลองจิจูดและรัศมีความแม่นยำ โดยจะยอมรับคำขอ HTTPS POST ไปยังปลายทางพร้อมกับเนื้อหาคำขอที่มีโครงสร้าง JSON ตัวอย่างต่อไปนี้แสดง URL ของคำขอและตัวอย่างเนื้อหาของคำขอ 

curl -X POST "https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d \
'{ "homeMobileCountryCode":310,
   "homeMobileNetworkCode":410,
   "radioType":"gsm",
   "carrier":"Vodafone",
   "considerIp":true
}'
 API สามารถแสดงข้อมูลสำหรับฟิลด์ข้อมูลมือถือทั่วไปจำนวนหนึ่งตามที่ระบุไว้ด้านล่าง

แหล่งข้อมูล

ตารางต่อไปนี้สรุปฟิลด์ในเนื้อหาคำขอของการเรียกใช้ปลายทางตำแหน่งทางภูมิศาสตร์ พร้อมกับประเภทข้อมูลที่ได้จากคำค้นหาดังกล่าว

แหล่งข้อมูล ข้อมูลที่แสดงผล รูปแบบการแสดงผล
ฟิลด์ข้อมูลอุปกรณ์เซลลูลาร์ เช่น ข้อมูลผู้ให้บริการ อุปกรณ์ และเครือข่าย พิกัดละติจูด/ลองจิจูดและรัศมีความแม่นยำ JSON
ข้อมูลเสาสัญญาณมือถือ เช่น รหัสพื้นที่ตำแหน่งและรหัสประเทศสำหรับอุปกรณ์เคลื่อนที่
ข้อมูลจุดเข้าใช้งาน Wi-Fi เช่น ที่อยู่ MAC และความแรงของสัญญาณ

วิธีใช้ Geolocation API

1 เริ่มต้นใช้งาน เริ่มต้นด้วยตั้งค่าโปรเจ็กต์ Google Cloud และทําตามวิธีการตั้งค่าที่ตามมา
2 ลองใช้คำขอตำแหน่งทางภูมิศาสตร์ เมื่อมีคีย์ API แล้ว คุณจะเริ่มทดสอบ Geolocation API โดยใช้ cURL หรือ Postman ได้ ดูรายละเอียดได้ที่คำขอตัวอย่าง ในคู่มือคำขอและการตอบกลับตำแหน่งทางภูมิศาสตร์
3 รับ CellID จากเสาส่งสัญญาณวิทยุต่างๆ ดูการคำนวณ CellID และ การคำนวณ newRadioCellID เพื่อรับสิทธิ์เข้าถึงเสาสัญญาณรุ่นเก่าและรุ่นใหม่ตามลำดับ
4 ทำความเข้าใจพื้นฐานของคำตอบ สำรวจการตอบกลับข้อมูลตำแหน่งทางภูมิศาสตร์เพื่อเตรียมพร้อมใช้ข้อมูลระดับความสูงสำหรับแอปของคุณ โปรดดูรายละเอียดที่ การตอบกลับตำแหน่งทางภูมิศาสตร์

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

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

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

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