Geolocation API'ye genel bakış

Coğrafi Konum API'si, mobil istemcinin algılayabileceği baz istasyonu ve Kablosuz erişim noktaları içeren HTTPS isteğini kabul eden bir hizmettir. Enlem/boylam koordinatları ve her geçerli 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 sağlamayan 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'si olmayan bir cihazın konumunu öğrenmek için baz istasyonlarından ve kablosuz ağ düğümlerinden elde edilen coğrafi verileri kullanabilirsiniz.

Coğrafi Konum API'sinin işleyiş şekli

Geolocation API; enlem/boylam koordinatlarını ve doğruluk yarıçapını döndürmek için hücresel cihaz veri alanları, baz istasyonu verilerini ve kablosuz erişim noktası dizi verilerini kullanır. JSON yapılandırılmış istek gövdesiyle birlikte uç noktasına gönderilen 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ına ilişkin verileri döndürebilir.

Kaynaklar

Aşağıdaki tabloda coğrafi konum uç nokta çağrısının istek gövdesindeki alanlar, bu tür sorgulardan sağlanan veri türüyle birlikte özetlenmektedir.

Veri kaynakları Döndürülen veriler Dönüş biçimi
Operatör, cihaz ve ağ bilgileri gibi hücresel cihaz verisi alanları. Enlem/boylam koordinatları ve doğruluk yarıçapı JSON
Baz istasyonu verileri: Konum alan kodu ve mobil ülke kodları gibi.
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 ile başlayın ve aşağıdaki kurulum talimatlarını tamamlayın.
2 Coğrafi konum isteğini deneyin API anahtarınızı aldıktan 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 alın Daha eski ve yeni kulelere erişmek için sırasıyla Cibül kimliğini hesaplama ve YeniRadioCellID'yi hesaplama konularına bakın.
4 Yanıtlarla ilgili temel bilgileri anlama Uygulamanızdaki yükseklik verilerini kullanmaya hazırlanmak için coğrafi konum veri 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 biri aracılığıyla bu API'yi istediğiniz dilde çağırın:

Java İstemcisi, Python İstemcisi, Go İstemcisi ve Google Haritalar Hizmetleri için Node.js İstemcisi, Apache 2.0 Lisansı altında sunulan, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bunları, kurulum talimatlarını ve örnek kodu da bulabileceğiniz GitHub'dan indirin.

Sırada ne var?