Roads API'ye genel bakış

Roads API, harita üzerindeki bir veya daha fazla nokta için enlem/boylam koordinatlarına sahip HTTPS isteklerini kabul eden bir hizmettir. 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 verileri hakkında bilgi alabilirsiniz. Bu yol meta verileriyle, sürüş uygulamalarınızı aşağıdaki özelliklerle geliştirebilirsiniz:

  • Enlem/boylam koordinatlarını bir yol veya yola bağlayın.
  • Bir koordinat kümesine en yakın yolu bulun
  • Yol segmentleri için hız sınırları alın

Roads API ile neler yapabilirsiniz?

Roads API kullanarak GPS koordinatlarını yolun geometrisine eşleyebilir ve yol segmentlerinde hız sınırını belirleyebilirsiniz.

  • Yollara Hızlı Geçiş Bu hizmet, sağlanan GPS koordinatlarına göre gidilen en olası yolları döndürür. Bir rota boyunca toplanan en fazla 100 GPS noktası belirtebilirsiniz. İsteğe bağlı olarak, hizmetin ek noktaların interpolasyonunu yaparak yolun geometrisine sorunsuz bir şekilde uyum sağlamasını da isteyebilirsiniz.
  • 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, 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 özellik etkin durumda kalacaktır.

Roads API'nin işleyiş şekli

Roads API; yol yolları, segmentler veya hız sınırı verileri sağlamak için enlem/boylam koordinatlarını veya yer kimliklerini kabul eden üç uç nokta kullanır. Aşağıdaki örnekte bir enlem/boylam koordinatları grubuna dayalı olarak en yakın yollar için yapılan 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 aracılığıyla kullanılabilen kaynaklar, döndürdüğü verilerle birlikte özetlenmektedir.

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

Bir rotadaki en fazla 100 GPS noktası dizisi döndürür. Yer kimlikleriyle birlikte yoldan alınmış boylam/enlem koordinatlarını içerir. Ayrıntıları, Yollara hızlı geçiş kılavuzundaki Yanıtlar bölümünde bulabilirsiniz.
  • JSON
En yakın yollar

Belirtilen her nokta için en yakın yolun yer kimlikleriyle birlikte en fazla 100 bağımsız enlem/boylam koordinatı dizisi. Puanların sürekli olması gerekmez. Ayrıntıları, En yakın yollar rehberindeki Yanıtlar bölümünde bulabilirsiniz.
Hız sınırı

100 adede kadar yol meta veri öğesi dizisi. Bunlar, KPH veya MPH cinsinden birimlere sahip hız sınırlarını ve yer kimliklerini içerir. Ayrıntılar için Hız sınırları kılavuzundaki Yanıtlar bölümüne bakın.

Roads API'yi kullanma

1 Yollara hızlı geçiş demosunu deneyin Bir parkur oluşturmak ve yollara giden uç noktanın nasıl sorunsuz veri sağladığını görmek için demoyu tıklayın. Yollara hızlı geçiş kılavuzundaki Demo bölümüne bakın. API anahtarına ihtiyacınız yoktur.
2 Hazırlanın İlk olarak Google Cloud projenizi oluşturma başlıklı makaleyi inceleyin, ardından aşağıdaki kurulum talimatlarını tamamlayın ve ardından API anahtarınızı nasıl kullanacağınızı öğrenin.
3 Yollara hızlı geçiş isteği özelliğini deneyin Yola geçiş örneklerinden birini kullanın ve kullanım alanınıza uygun bir tanesini deneyin.
4 Yolunuzda hız sınırı belirleme Yola geçiş isteğiniz için sağladığınız yol verilerinin aynısını kullanarak hız sınırı sorgusu yapın. Yol kullanan örnek istekbölümüne bakın.
5 Uzun yolların nasıl işleneceğini öğrenin. İleri düzey kavramlar kılavuzundaki Uzun yolları işleme ile ilgili bölümleri takip edin.
6 Yol verilerini kendi uygulamanıza dahil edin! Kendi uygulamanıza yol verileri işlevselliği oluşturmaya başlamak için yol alınan demodaki ayrıntılı kod örneğine 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?