Roads API'ye genel bakış

Roads API, bir haritada bir veya daha fazla noktanın enlem/boylam koordinatlarını içeren 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 kullanma

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

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

Roads API ile neler yapabilirsiniz?

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

  • Yola sabitleme Bu hizmet, sağlanan GPS koordinatlarına göre en olası yolları döndürür. Rota boyunca toplanan en fazla 100 GPS noktasını belirtebilirsiniz. İsteğe bağlı olarak, hizmetin ek noktalar eklemesini de isteyebilirsiniz. Bu durumda, yolun geometrisini sorunsuz bir şekilde izleyen bir yol elde edilir.
  • Yakındaki 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 kesintisiz bir yolun parçası olması gerekmez.
  • Hız sınırları Bu hizmet, bir yol segmenti için belirtilen hız sınırını döndürür. Hız sınırı hizmeti, öğe izleme 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'nin işleyiş şekli

Roads API, yol yolları, segmentler veya hız sınırı verileri sağlamak için enlem/boylam koordinatlarını ya da yer kimliklerini kabul eden üç uç nokta kullanır. Aşağıdaki örnekte, bir enlem/boylam koordinat grubuna göre en yakın yollar için 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 aracılığıyla kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmiştir.

Veri kaynakları Döndürülen veriler Dönüş biçimi
Yola geçirme

Bir rotadaki en fazla 100 GPS noktasından oluşan bir dizi döndürür. Yer kimliklerinin yanı sıra yola göre yakalanan boylam/enlem koordinatlarını içerir. Ayrıntılar için Yollara sabitleme kılavuzundaki Yanıtlar bölümüne bakın.
  • JSON
En yakın yollar

Belirtilen her noktanın en yakın yolunun yer kimlikleriyle birlikte 100'e kadar bağımsız enlem/boylam koordinatından oluşan bir dizi. Noktaların sürekli olması gerekmez. Ayrıntılar için En yakın yollar kılavuzundaki Yanıtlar bölümüne bakın.
Hız sınırları

En fazla 100 yol meta verisi öğesinden oluşan bir dizi. Bunlar, hız sınırlarını ve yer kimliklerini içerir. Birim olarak KPH veya MPH kullanılır. 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 Yola kilitleme demosunu deneyin Bir rota oluşturmak ve yola yaklaşma uç noktasının nasıl sorunsuz veri sağladığını görmek için demoyu tıklayın. Yollara sabitleme kılavuzundaki Demo bölümünü inceleyin. API anahtarına ihtiyacınız yoktur.
2 Kurulum Google Cloud projenizi oluşturma ile başlayın ve sonraki kurulum talimatlarını tamamlayın. Ardından API anahtarınızı nasıl kullanacağınızı öğrenin.
3 Yola yaklaşma isteği deneyin Yola yaklaşma örneklerinden birini kullanın ve kullanım alanınızla alakalı bir örnek deneyin.
4 Yol rotanız için hız sınırlarını öğrenme Yollara yaklaşma isteğiniz için sağladığınız yol verilerini kullanarak hız sınırı sorgusu gönderin. Yol kullanan örnek istekbölümüne bakın.
5 Uzun yolları nasıl işleyeceğinizi öğrenin. Gelişmiş kavramlar kılavuzundaki Uzun yolları işleme bölümündeki adımları uygulayın.
6 Yol verilerini kendi uygulamanıza ekleyin. Kendi uygulamanıza yol verileri işlevini eklemeye başlamak için yol fotoğrafı demo'sundaki ayrıntılı kod örneğine göz atın.

Kullanılabilir istemci kitaplıkları

Aşağıdaki istemci kitaplıklarından birini kullanarak 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ı kapsamında açık kaynaklı olan, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bunları GitHub'dan indirebilirsiniz. GitHub'da kurulum talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?