Roads API'ye genel bakış

Roads API, bir haritadaki bir veya daha fazla noktanın enlem/boylam koordinatlarını içeren 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ını, tahmini varış sürelerini 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 koordinat kümesi 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ı grubuna göre seyahat edilen en olası yolları döndürür. Bir rota boyunca toplanan en fazla 100 GPS noktası belirtebilirsiniz. İsterseniz hizmetin ek noktalar eklemesini de isteyebilirsiniz. Bu sayede, yolun geometrisini sorunsuz bir şekilde takip eden bir rota elde edersiniz.
  • Nearest Roads 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, Varlık Takibi 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 nasıl çalışır

Roads API, yol rotaları, 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 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 ö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. Yola sabitlenmiş boylam/enlem koordinatlarının yanı sıra yer kimliklerini içerir. Ayrıntılar için Yollara hızlı geçiş 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 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 veri öğesi içeren bir dizi. Bu dosyalarda hız sınırları ve yer kimlikleri bulunur. 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 hızlı geçiş demosunu deneyin Bir rota oluşturmak ve yollara hızlı geçiş uç noktasının nasıl sorunsuz veri sağladığını görmek için demoyu tıklayın. Yollara hızlı geçiş kılavuzundaki Demo bölümüne bakın. API anahtarına ihtiyacınız yoktur.
2 Kurulumu tamamlama 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 hızlı geçiş isteği göndermeyi deneme Yollara hızlı geçiş ö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 hızlı geçiş isteğiniz için sağladığınız yol verilerini kullanarak bir hız sınırı sorgusu gönderin. Yol kullanan örnek istek bölümüne bakın.
5 Uzun yolları nasıl işleyeceğinizi öğrenin. İleri düzey kavramlar kılavuzundaki Uzun yolları işleme ile ilgili bölümleri inceleyin.
6 Yol verilerini kendi uygulamanıza ekleyin. Yol verisi işlevini kendi uygulamanıza eklemeye başlamak için yola tutturulmuş demo'daki ayrıntılı kod örneğine bakın.

Kullanılabilir istemci kitaplıkları

Bu API'yi, aşağıdaki istemci kitaplıklarından biri aracılığıyla istediğiniz dilde çağırabilirsiniz:

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 kitaplıkları GitHub'dan indirebilirsiniz. Ayrıca GitHub'da yükleme talimatlarını ve örnek kodları da bulabilirsiniz.

Sırada ne var?