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 ve hız sınırları gibi meta verilerle birlikte bir yer kimliği döndürür.

Roads API neden kullanılmalı?

Roads API ile hız sınırları, tahmini varış süreleri 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 veya daha fazla yolla 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 Hızlı Geçiş Bu hizmet, sağlanan GPS koordinatlarına göre en olası seyahat edilen 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 hizalama

Bir rotadan en fazla 100 GPS noktası içeren bir dizi döndürür. Yola sabitlenmiş boylam/enlem koordinatlarının yanı sıra yer kimliklerini içerir. Ayrıntılar için Yollara tutturma kılavuzundaki Yanıtlar bölümüne bakın.
  • 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. Ayrıntılar için Hız sınırları kılavuzundaki Yanıtlar bölümüne bakın.

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 aşağıdaki kurulum talimatlarını tamamlayın, ardından API anahtarınızı nasıl kullanacağınızı öğrenin.
3 Yollara tutturma isteği göndermeyi deneme Yollara tutturma ö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ı alma Yollara tutturma isteğiniz için sağladığınız 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. İleri düzey kavramlar kılavuzundaki Uzun yolları işleme ile ilgili bölümleri 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 İstemci Kitaplığı, Python İstemci Kitaplığı, Go İstemci Kitaplığı ve Node.js İstemci Kitaplığı, Apache 2.0 Lisansı kapsamında açık kaynaklı olan, topluluk destekli istemci kitaplıklarıdır. Bu dosyaları GitHub'dan indirebilirsiniz. GitHub'da kurulum talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?