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

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