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ış zamanlarını 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 bölümleri için hız sınırlarını öğrenme

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 Hızlı Geçiş Bu hizmet, sağlanan GPS koordinatları grubuna 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 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 yayınlanan hız sınırını döndürür. Hız sınırı hizmeti, öğe izleme lisansı olan tüm müşteriler tarafından kullanılabilir. Kullandıkça öde fiyatlandırmasına geçen Google Haritalar Platformu Premium Planı müşterileri 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 göre 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
Yollara hızlı geçiş

Bir rotadan en fazla 100 GPS noktası içeren bir dizi döndürür. Yer kimlikleriyle birlikte yola göre ayarlanmış 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 adede kadar bağımsız enlem/boylam koordinatları dizisi. Puanları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 veri öğesinden oluşan bir dizi. Bunlar, hız sınırlarını ve yer kimliklerini içerir. Birimler km/sa. veya mil/sa. cinsindendir. Hız sınırları rehberindeki Yanıtlar bölümünde ayrıntıları inceleyin.

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 veri sağladığını görmek için demoyu tıklayın. Yollara yaslama kılavuzundaki Demo bölümüne bakın. API anahtarına ihtiyacınız yoktur.
2 Kurulumu yapma 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ğinde bulunmayı 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 aynı yol verilerini kullanarak hız sınırı sorgusu gönderin. Yol kullanan örnek istek bölümüne bakın.
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. Yol verisi işlevini kendi uygulamanıza eklemeye başlamak için yola tutturulmuş demo videosundaki 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 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ı ve topluluk tarafından desteklenen istemci kitaplıklarıdır. Bu dosyaları GitHub'dan indirebilirsiniz. GitHub'da kurulum talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?