Geolocation API'ye genel bakış

Geolocation API, bir mobil istemcinin algılayabileceği baz istasyonu ve kablosuz erişim noktalarıyla HTTPS isteğini kabul eden bir hizmettir. Geçerli her giriş için enlem/boylam koordinatlarını ve sonucun doğruluğunu gösteren bir yarıçapı döndürür.

Geolocation API'yi neden kullanmalısınız?

Yerel coğrafi konum özellikleri sağlamayan mobil cihazları bulmak için Geolocation API'yi kullanın.

Geolocation API ile yapabilecekleriniz

Coğrafi Konum API'si ile, yerel coğrafi konum veya GPS özelliği olmayan bir cihazın konumunu almak için baz istasyonlarından ve kablosuz düğümlerden alınan coğrafi verileri kullanabilirsiniz.

Geolocation API'nin 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ı dizisi verilerini kullanır. Uç noktasına, JSON yapılandırılmış istek gövdesiyle birlikte bir HTTPS POST isteği gönderilir. 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 bir dizi ortak hücresel veri alanı için veri döndürebilir.

Kaynaklar

Aşağıdaki tabloda, coğrafi konum uç noktası çağrısının istek gövdesindeki alanlar ve bu tür sorgulardan sağlanan veri türü özetlenmiştir.

Veri kaynakları Döndürülen veriler Dönüş biçimi
Operatör, cihaz ve ağ bilgileri gibi hücresel cihaz 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.

Geolocation API'yi kullanma

1 Kurulum Google Cloud projenizi oluşturarak başlayın ve kurulum talimatlarını tamamlayın.
2 Coğrafi konum isteğini deneyin API anahtarınız olduğunda cURL veya Postman'i kullanarak Coğrafi Konum API'sini test etmeye başlayabilirsiniz. Ayrıntılar için Coğrafi konum istekleri ve yanıtı rehberindeki Örnek istekler bölümüne bakın.
3 Farklı radyo kulelerinden cellID'yi alma Sırasıyla eski ve yeni baz istasyonlarına erişmek için Calculating cellID ve Calculating newRadioCellID başlıklı makalelere bakın.
4 Yanıtlarla ilgili temel bilgileri öğrenme Uygulamanızda yükseklik verilerini kullanmaya hazırlanmak için coğrafi konum verileri yanıtlarını inceleyin. Ayrıntılar için Coğrafi konum yanıtları başlıklı makaleyi inceleyin.

Kullanılabilir istemci kitaplıkları

Bu API'yi aşağıdaki istemci kitaplıklarından birini kullanarak tercih ettiğiniz dilde çağırın:

Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi, Apache 2.0 Lisansı kapsamında açık kaynaklı olarak sunulan ve topluluk tarafından desteklenen istemci kitaplıklarıdır. Bu kitaplıkları GitHub'dan indirebilirsiniz. GitHub'da kurulum talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?