Roads API'ye genel bakış

Roads API, harita üzerinde bir veya daha fazla nokta için enlem/boylam koordinatlarıyla HTTPS isteklerini kabul eden bir hizmettir. Araç, yakındaki yol segmentlerini bulmak için bu noktaları kullanır ve en yakın yol segmenti ve hız sınırları gibi meta verilerle birlikte bir Yer Kimliği döndürür.

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

Roads API ile hız sınırları, tahmini varış süreleri veya diğer yol meta verilerini alabilirsiniz. Bu yol meta verileri sayesinde sürüş uygulamalarınızı aşağıdaki özelliklerle geliştirebilirsiniz:

  • Enlem/boylam koordinatlarını yola veya yollara bağlayın.
  • Bir dizi koordinat için en yakın yolu bulma
  • Yol segmentleri için hız sınırlarını öğrenin

Roads API ile yapabilecekleriniz

Roads API ile, GPS koordinatlarını yolun geometrisiyle eşleyebilir ve yol segmentlerinde hız sınırını belirleyebilirsiniz.

  • Yollara Hızlı Geçiş Bu hizmet, sağlanan GPS koordinatlarına dayalı olarak seyahat edilen en olası yolları döndürür. Bir rota boyunca toplanan 100'e kadar GPS noktası belirtebilirsiniz. İsteğe bağlı olarak, hizmetten ek noktaların interpolasyonunu yapmasını da isteyebilirsiniz. Bu sayede, yolun geometrisine sorunsuz bir şekilde uyan bir yol elde edebilirsiniz.
  • En Yakın Yollar Bu hizmet, bir GPS noktası için en yakın yol segmentini döndürür. En fazla 100 GPS noktası belirtebilirsiniz. Belirttiğiniz noktaların, sürekli bir yolun parçası olması gerekmez.
  • Hız sınırları Bu hizmet, bir yol segmenti için gönderilen hız sınırını döndürür. Hız Sınırı hizmeti, Öğe İzleme lisansına sahip tüm müşteriler tarafından kullanılabilir. Kullandıkça öde fiyatlandırmasına geçiş yapan Google Haritalar Platformu Premium Planı müşterileri için bu özellik etkin kalır.

Roads API nasıl çalışır?

Roads API; yol yolları, segmentler veya hız sınırı verilerini sağlamak için enlem/boylam koordinatlarını veya yer kimliklerini kabul eden üç uç nokta kullanır. Aşağıdaki örnekte, bir dizi enlem/boylam koordinatlarına dayalı en yakın yollara yönelik bir istek gösterilmektedir:

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

Kaynaklar

Aşağıdaki tabloda, Roads API üzerinden kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmektedir.

Veri kaynakları Döndürülen veriler İade biçimi
Yollara hızlı geçiş

Bir rotadan en fazla 100 GPS noktası dizisini döndürür. Yer kimlikleriyle birlikte yol ayrılmış boylam/enlem koordinatlarını içerir. Ayrıntılar için Yollara hızlı geçiş kılavuzundaki Yanıtlar bölümüne bakın.
  • JSON
En yakın yollar

Belirtilen her bir nokta için en yakın yolun yer kimlikleriyle birlikte en fazla 100 bağımsız enlem/boylam koordinatlarından oluşan bir dizi. Puanların sürekli olması gerekmez. En yakın yollar rehberindeki Yanıtlar bölümünde ayrıntılara bakın.
Hız sınırları

100 adede kadar yol meta verisi dizisi. Hız sınırları ve yer kimlikleri içeren bu değerler, kilometre/sa (km/sa) veya mil/sa (mil/sa) birimlerle sunulur. Ayrıntıları Hız sınırları kılavuzundaki Yanıtlar bölümünde bulabilirsiniz.

Roads API nasıl kullanılır?

1 Yollara hızlı geçiş demosunu deneyin Parkur oluşturmak ve yollara hızlı geçiş uç noktasına nasıl sorunsuz veri sağladığını görmek için demoyu tıklayın. Yollara hızlı geçiş kılavuzundaki Demo'ya bakın. API anahtarına ihtiyacınız yoktur.
2 Kurulumu yapın Google Cloud projenizi oluşturun bölümünü inceleyin, sonraki kurulum talimatlarını uygulayın ve API anahtarınızı nasıl kullanacağınızı öğrenin.
3 Yola hızlı geçiş isteğini deneyin Yola hızlı geçiş örneklerinden birini kullanın ve kullanım alanınıza uygun bir örnek deneyin.
4 Yolunuz için hız sınırları hakkında bilgi alma Yollara hızlı geçiş isteğiniz için sağladığınız yol verilerini kullanarak bir hız sınırı sorgusu yayınlayın. Yol kullanan örnek istekbölümüne bakın.
5 Uzun yolları nasıl işleyeceğinizi öğrenin. İleri düzey kavramlar kılavuzundaki Uzun yolları işleme bölümündeki bölümleri takip edin.
6 Yol verilerini kendi uygulamanıza entegre edin! Kendi uygulamanızda yol verileri işlevi oluşturmaya başlamak için yol görünümündeki ayrıntılı kod örneğine göz atı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ı kapsamında açık kaynaklı, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bu uygulamaları GitHub'dan indirin. Burada yükleme talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?