Roads API'ye genel bakış

Roads API, bir haritadaki bir veya daha fazla nokta için enlem/boylam koordinatlarıyla HTTPS isteklerini kabul eden bir hizmettir. Bu noktaları kullanarak yakındaki yol segmentlerini bulur ve en yakın yol segmenti ile hız sınırları gibi meta verilerle birlikte bir yer kimliği döndürür.

Roads API neden kullanılmalıdır?

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

  • Enlem/boylam koordinatlarını bir 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ı alma

Roads API ile yapabilecekleriniz

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

  • Yollara Yapışma Bu hizmet, sağlanan GPS koordinatları grubuna göre gidilen en olası yolları döndürür. Bir rota boyunca toplanan 100'e kadar GPS noktası belirtebilirsiniz. İsteğe bağlı olarak, hizmetin ek noktalar enterpolasyonunu yapmasını da isteyebilirsiniz. Bu durumda, yolun geometrisini sorunsuz bir şekilde takip eden bir rota elde edilir.
  • 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 takibi lisansı olan tüm müşteriler tarafından kullanılabilir. Google Haritalar Platformu Premium Planı müşterilerinden kullandıkça öde fiyatlandırmasına geçenler bu özelliği kullanmaya devam edebilir.

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

Roads API, yol güzergahları, 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 dizi enlem/boylam koordinatına dayalı olarak en yakın yollarla ilgili 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 özetlenmektedir.

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

Bir rotadan 100'e kadar GPS noktası içeren bir dizi döndürür. Yer kimlikleriyle birlikte yola göre hizalanmış boylam/enlem koordinatlarını içerir. Ayrıntıları Yollara yaslama 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 100'e kadar bağımsız enlem/boylam koordinatları dizisi. Puanları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 öğesinden oluşan bir dizi. Bunlar, hız sınırlarını ve yer kimliklerini içerir. Birimler km/sa. veya mil/sa. cinsindendir. 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 tutturma demosunu deneyin Bir parça oluşturmak ve yollara tutturma uç noktasının nasıl sorunsuz veriler sağladığını görmek için demoyu tıklayın. Yollara tutturma kılavuzundaki Demo bölümüne bakın. API anahtarına ihtiyacınız yoktur.
2 Kurulum Google Cloud projenizi ayarlama ile başlayın ve kurulum talimatlarını tamamlayın. Ardından API anahtarınızı nasıl kullanacağınızı öğrenin.
3 Yollara tutturma isteği göndermeyi deneyin Yollara tutturma örneklerinden birini kullanın ve kullanım alanınızla alakalı bir örneği deneyin.
4 Yolunuzdaki hız sınırlarını öğrenme Yollara tutturma isteğiniz için sağladığınız yol verilerini kullanarak hız sınırı sorgusu gönderin. Yol kullanan örnek isteği inceleyin.
5 Uzun yolların nasıl işleneceğini öğrenin. Gelişmiş kavramlar rehberindeki Uzun yolları işleme bölümlerini inceleyin.
6 Yol verilerini kendi uygulamanıza entegre edin. Kendi uygulamanızda yol verileri işlevselliği oluşturmaya başlamak için yola tutturulmuş demo örneğindeki ayrıntılı kod örneğine bakın.

Kullanılabilir istemci kitaplıkları

Bu API'yi aşağıdaki istemci kitaplıklarından birini kullanarak tercih ettiğ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ı olarak sunulan ve topluluk tarafından desteklenen istemci kitaplıklarıdır. Bu kitaplıkları GitHub'dan indirebilirsiniz. GitHub'da kurulum talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?