Geolocation API'ye genel bakış

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:

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?