Roads API'ye genel bakış

Roads API, haritada 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 verilerine ulaşabilirsiniz. Bu yol meta verileriyle, sürüş uygulamalarınızı aşağıdaki özelliklerle geliştirebilirsiniz:

  • Enlem/boylam koordinatlarını bir yol veya yolla 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 neler yapabilirsiniz?

Roads API ile GPS koordinatlarını yolun geometrisine eşleyebilir ve yol segmentleri boyunca hız sınırını belirleyebilirsiniz.

  • Yollara Hızlı Geçiş Bu hizmet, sağlanan GPS koordinatları kümesine göre gidilen en olası yolları döndürür. Bir rota boyunca toplanan 100 adede kadar GPS noktası belirtebilirsiniz. İsteğe bağlı olarak, hizmetin ek noktaları interpolasyon yapmasını da isteyebilirsiniz. Bu sayede yolun geometrisine sorunsuzca uyan bir yol sağlanır.
  • 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 yayınlanan 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 olmaya devam etmektedir.

Roads API'nin işleyiş şekli

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 enlem/boylam koordinatlarına göre 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 özetlenmiştir.

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

Bir rotadan en fazla 100 GPS noktası dizisi döndürür. Yer kimlikleriyle birlikte yola eklenen 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 koordinatlarından oluşan dizi. Noktaların sürekli olması gerekmez. Ayrıntıları, En yakın yollar kılavuzundaki Yanıtlar bölümünde bulabilirsiniz.
Hız sınırları

En fazla 100 yol meta verisi öğesi içeren dizi. Bunlar, KPH veya MPH cinsinden birimlerle birlikte hız sınırlarını ve yer kimliklerini içerir. Ayrıntıları, Hız sınırları kılavuzundaki Yanıtlar bölümünde bulabilirsiniz.

Roads API'yi kullanma

1 Yollara hızlı geçiş demosunu deneyin Bir parkur oluşturmak için demoyu tıklayın ve yollara hızlı geçişin nasıl sorunsuz veri sağladığını görün. Yollara hızlı geçiş kılavuzundaki Tanıtım bölümüne bakın. API anahtarına ihtiyacınız yoktur.
2 Hazırlanın İlk olarak Google Cloud projenizi oluşturun bölümüne geçin, ardından aşağıdaki kurulum talimatlarını uygulayı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 Yollara hızlı geçiş örneklerinden birini kullanın ve kullanım alanınıza uygun bir örnek deneyin.
4 Yolda hız sınırları belirleme Yola hızlı geçiş isteğiniz için sağladığınız yol verilerini kullanarak bir hız sınırı sorgusu gerçekleştirin. 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 ekleyin! Kendi uygulamanıza yol verileri işlevi 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 biri aracılığıyla bu API'yi istediğiniz dilde ç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ı, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bunları, kurulum talimatlarını ve örnek kodu da bulabileceğiniz GitHub'dan indirin.

Sırada ne var?