
Geolocation API เป็นบริการที่ยอมรับคําขอ HTTPS พร้อมเสาสัญญาณมือถือและจุดเข้าใช้งาน Wi-Fi ที่ไคลเอ็นต์บนอุปกรณ์เคลื่อนที่ตรวจจับได้ โดยจะแสดงผลพิกัดละติจูด/ลองจิจูดและรัศมีซึ่งระบุความถูกต้องของผลลัพธ์สําหรับอินพุตที่ถูกต้องแต่ละรายการ
เหตุผลที่ควรใช้ Geolocation API
ใช้ Geolocation API เพื่อค้นหาอุปกรณ์เคลื่อนที่ที่ไม่มีฟีเจอร์ตําแหน่งทางภูมิศาสตร์แบบเนทีฟ
สิ่งที่คุณทําได้ด้วย Geolocation API
เมื่อใช้ Geolocation API คุณจะใช้ข้อมูลทางภูมิศาสตร์จากเสาสัญญาณและโหนด Wi-Fi เพื่อดูตําแหน่งของอุปกรณ์ที่ไม่มีตําแหน่งทางภูมิศาสตร์หรือ GPS ได้
วิธีการทํางานของ Geolocation API
Geolocation API ใช้ช่องข้อมูลเครือข่ายมือถือ ข้อมูลเสาสัญญาณมือถือ และข้อมูลอาร์เรย์จุดเข้าใช้งาน Wi-Fi เพื่อแสดงพิกัดละติจูด/ลองจิจูดและรัศมีความแม่นยํา โดยยอมรับคําขอ HTTPS POST ไปยังปลายทางพร้อมกับเนื้อหาของคําขอ Structured Data JSON ตัวอย่างต่อไปนี้แสดง URL คําขอและเนื้อหาคําขอตัวอย่าง
https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY { "homeMobileCountryCode": 310, "homeMobileNetworkCode": 410, "radioType": "gsm", "carrier": "Vodafone", "considerIp": true, "cellTowers": [ // See the Cell Tower Objects section below. ], "wifiAccessPoints": [ // See the WiFi Access Point Objects section below. ] }API แสดงผลข้อมูลสําหรับช่องข้อมูลเครือข่ายมือถือทั่วไปได้ที่ระบุไว้ด้านล่าง
แหล่งข้อมูล
ตารางต่อไปนี้สรุปช่องในส่วนเนื้อหาของคําขอในการเรียกตําแหน่งทางภูมิศาสตร์ รวมถึงประเภทข้อมูลที่ได้จากการค้นหาดังกล่าว
แหล่งข้อมูล | ข้อมูลที่ส่งคืน | รูปแบบการคืนสินค้า |
---|---|---|
ช่องข้อมูลอุปกรณ์เซลล์ เช่น ผู้ให้บริการ อุปกรณ์ และข้อมูลเครือข่าย | พิกัดละติจูด/ลองจิจูดและรัศมีความแม่นยํา | JSON |
ข้อมูลเสาสัญญาณมือถือ เช่น รหัสพื้นที่และรหัสประเทศบนอุปกรณ์เคลื่อนที่ | ||
ข้อมูลจุดเข้าใช้งาน Wi-Fi เช่น ที่อยู่ MAC และความแรงของสัญญาณ |
วิธีใช้ Geolocation API
1 | ตั้งค่า | เริ่มต้นด้วยตั้งค่าโปรเจ็กต์ Google Cloud และทําตามวิธีการตั้งค่าให้เสร็จสมบูรณ์หลังจากนั้น |
2 | ลองใช้คําขอตําแหน่งทางภูมิศาสตร์ | เมื่อมีคีย์ API แล้ว คุณจะเริ่มทดสอบ Geolocation API ได้โดยใช้ cURL หรือ Postman ดูรายละเอียดได้ที่ตัวอย่างคําขอในคู่มือคําขอตําแหน่งทางภูมิศาสตร์และการตอบสนอง |
3 | รับ CeID จากหอวิทยุต่างๆ | โปรดดูการคํานวณ ID เซลล์ และ การคํานวณ newRadioCellID เพื่อรับสิทธิ์เข้าถึงหอคอยรุ่นเก่าและใหม่ตามลําดับ |
4 | ทําความเข้าใจพื้นฐานการตอบกลับ | สํารวจข้อมูลคําตอบตําแหน่งทางภูมิศาสตร์เพื่อเตรียมพร้อมที่จะใช้ข้อมูลระดับความสูงสําหรับแอปของคุณ ดูรายละเอียดได้ที่การตอบกลับตําแหน่งทางภูมิศาสตร์ |
ไลบรารีของไคลเอ็นต์ที่พร้อมใช้งาน
เรียก API นี้ในภาษาที่คุณเลือกผ่านไลบรารีของไคลเอ็นต์ต่อไปนี้
- ไคลเอ็นต์ Java สําหรับบริการของ Google Maps
- ไคลเอ็นต์ Python สําหรับบริการ Google Maps
- ไคลเอ็นต์ Go สําหรับบริการ Google Maps
- ไคลเอ็นต์ Node.js สําหรับบริการของ Google Maps
ไคลเอ็นต์ Java, ไคลเอ็นต์ Python, Go Client และ Node.js สําหรับ Google Maps บริการเป็นไลบรารีของไคลเอ็นต์ที่รองรับชุมชน ซึ่งเปิดอยู่ภายใต้ใบอนุญาต Apache 2.0 ดาวน์โหลดได้จาก GitHub ซึ่งคุณสามารถดูวิธีการติดตั้งและรหัสตัวอย่าง
ขั้นตอนถัดไป
- เริ่มต้นใช้งานตัวอย่างคําขอและการตอบกลับ: ไปที่คําขอและคําตอบตําแหน่งทางภูมิศาสตร์
- ทําตามแนวทางปฏิบัติแนะนํา: ไปที่แนวทางปฏิบัติแนะนําสําหรับบริการเว็บ
- ทําความเข้าใจการเรียกเก็บเงิน: ไปที่การใช้งานและการเรียกเก็บเงิน