Geolocation API'ye genel bakış

Geolocation API, mobil istemcinin algılayabileceği baz istasyonu ve kablosuz erişim noktalarıyla HTTPS isteği kabul eden bir hizmettir. Her bir geçerli giriş için sonucun doğruluğunu belirten enlem/boylam koordinatları ve yarıçapını 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 neler yapabilirsiniz?

Coğrafi Konum API'si ile yerel coğrafi konum veya GPS işlevi olmayan bir cihazın konumunu öğrenmek için baz istasyonlarından ve WiFi düğümlerinden alınan coğrafi verileri kullanabilirsiniz.

Geolocation API'nin işleyiş şekli

Geolocation API; enlem/boylam koordinatları ve doğruluk yarıçapı döndürmek için hücresel cihaz veri alanlarını, baz istasyonu verilerini ve WiFi erişim noktası dizi verilerini kullanır. JSON yapılandırılmış istek gövdesiyle birlikte uç noktasına bir HTTPS POST isteği kabul eder. Aşağıdaki örnekte, istek URL'si ve bir örnek istek gövdesi gösterilmektedir: 

    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, aşağıda belirtildiği üzere bir dizi yaygın 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ü özetlenmektedir.

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 ağ erişim noktası verileri.

Geolocation API'yi kullanma

1 Hazırlanma Google Cloud projenizi ayarlayın ile başlayın ve sonraki kurulum talimatlarını tamamlayın.
2 Coğrafi konum isteğini deneme Bir API anahtarınız olduktan 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 Hücresel radyodan baz istasyonu kimliği alın Sırasıyla eski ve yeni kulelere erişmek için Ciddi hücreyi hesaplama ve NewRadioCellID'yi hesaplama bölümlerine bakın.
4 Yanıt vermeyle ilgili temel bilgileri anlama Uygulamanız için yükseklik verilerini kullanmaya hazır olmak için coğrafi konum verisi yanıtlarını keşfedin. 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 seçtiğiniz dilde bu API'yi çağırın:

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

Sırada ne var?