Geolocation API, mobil istemcinin algılayabileceği baz istasyonu ve WiFi erişim noktaları içeren HTTPS isteğini kabul eden bir hizmettir. Enlem/boylam koordinatları ve geçerli her giriş için sonucun doğruluğunu belirten bir yarıçap döndürür.
Coğrafi Konum API'sini neden kullanmalısınız?
Yerel coğrafi konum özellikleri sunmayan mobil cihazları bulmak için Geolocation API'yi kullanın.
Coğrafi Konum API'si ile neler yapabilirsiniz?
Geolocation API ile yerel coğrafi konumu veya GPS'i olmayan bir cihazın konumunu bulmak için baz istasyonlarından ve WiFi düğümlerinden elde edilen coğrafi verileri kullanabilirsiniz.
Coğrafi Konum API'sinin işleyiş şekli
Coğrafi Konum API'si, enlem/boylam koordinatlarını ve doğruluk yarıçapını döndürmek için hücresel cihaz veri alanlarını, baz istasyonu verilerini ve kablosuz erişim noktası dizi verilerini kullanır. JSON yapılandırılmış istek gövdesiyle birlikte uç noktasına giden HTTPS POST isteğini kabul eder. Aşağıdaki örnekte istek URL'si ve örnek bir istek gövdesi gösterilmektedir:
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, aşağıda belirtildiği gibi çeşitli yaygın hücresel veri alanları için veri döndürebilir.
Kaynaklar
Aşağıdaki tabloda, coğrafi konum uç nokta çağrısının istek gövdesindeki alanlar ve bu tür sorgulardan sağlanan veri türü özetlenmektedir.
Veri kaynakları | Döndürülen veriler | İade biçimi |
---|---|---|
Operatör, cihaz ve ağ bilgileri gibi cep telefonu veri alanları. | Enlem/boylam koordinatları ve doğruluk yarıçapı | JSON |
Konum alan kodu ve mobil ülke kodları gibi baz istasyonu verileri. | ||
MAC adresi ve sinyal gücü gibi kablosuz erişim noktası verileri. |
Coğrafi Konum API'si nasıl kullanılır?
1 | Hazırlanın | Google Cloud projenizi oluşturma işlemiyle başlayın ve aşağıdaki kurulum talimatlarını tamamlayın. |
2 | Coğrafi konum isteği yapmayı deneyin | API anahtarınızı oluşturduktan sonra cURL veya Postman kullanarak Geolocation API'yi test etmeye başlayabilirsiniz. Ayrıntılar için Coğrafi konum istekleri ve yanıt kılavuzundaki Örnek istekler bölümüne bakın. |
3 | Farklı radyo kulelerinden baz istasyonu kimliğini alma | Daha eski ve yeni kulelere erişmek için sırasıyla Calculating mobileID ve Calculating newRadioCellID bölümlerine bakın. |
4 | Yanıtlarla ilgili temel bilgileri anlama | Uygulamanızın yükseklik verilerini kullanmaya hazırlanmak için coğrafi konum verisi yanıtlarını inceleyin. Ayrıntılar için Coğrafi konum yanıtları bölümüne bakın. |
Kullanılabilir istemci kitaplıkları
Aşağıdaki istemci kitaplıklarından birini kullanarak bu API'yi istediğiniz dilde çağırın:
- Google Haritalar Hizmetleri için Java İstemcisi
- Google Haritalar Hizmetleri için Python İstemcisi
- Google Haritalar Hizmetleri için İstemciye Git
- Google Haritalar Hizmetleri için Node.js İstemcisi
Java İstemcisi, Python İstemcisi, Go İstemcisi ve Google Haritalar Hizmetleri için Node.js İstemcisi, Apache 2.0 Lisansı altında açık kaynaklı, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bunları GitHub'dan indirin. Burada kurulum talimatlarını ve örnek kodu da bulabilirsiniz.
Sırada ne var?
- Örnek istek ve yanıtları kullanmaya başlama: Coğrafi konum isteği ve yanıtı bölümüne gidin
- En iyi uygulamaları takip edin: Web Hizmeti En İyi Uygulamaları bölümüne gidin.
- Faturalandırmayı anlama: Kullanım ve Faturalandırma'ya gidin.