Roads API, belirli bir yol için gönderilen hız sınırını döndürür bölümünü seçin. Değişken hız sınırlarına sahip yol segmentleri için varsayılan değer hız sınırı döndürüldü.
Roads API tarafından döndürülen hız sınırı verilerinin doğruluğu garanti edilemez. Sağlanan hız sınırı verileri gerçek zamanlı değildir ve tahmini, yanlış, eksik ve/veya güncelliğini yitirmiş içeriklerdir. Kapsam ayrıntılarını inceleyin hız sınırı verilerinin bulunduğu bölgeleri görün.
İstekler
Hız sınırıyla ilgili istekler HTTPS üzerinden gönderilmelidir ve aşağıdaki biçimdedir:
https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY
.
Parametre kullanımı
Gerekli parametreler
path
veyaplaceId
parametresi.path
— Verileri temsil eden en fazla 100 enlem/boylam çiftinden oluşan bir liste bir yol sunar. Enlem ve boylam değerleri virgülle ayrılmalıdır. Enlem/boylam çiftleri dikey çizgi karakteriyle ayrılmalıdır: "|".path
parametresini sağladığınızda, API önce seyahat ettiği en olası yol (bu, her Sprint’te olduğu gibi)snapToRoads
isteği), ardından daha fazla dönüşüm elde edin. API'nin yolu tutturmasını istemiyorsanız aşağıda açıklandığı gibi birplaceId
parametresi iletmelidir. Aşağıdaki örnek üç enlem/boylam çiftine sahippath
parametresini gösterir:path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796
.placeId
— Bir veya daha fazla yol segmentini temsil eden yer kimlikleri. Her yer kimliğinin farklı bir türe değil, bir yol segmentine işaret ettiğinden emin olun pek de iyi olmadığını unutmayın. Her bir anahtar kelime için en fazla 100 yer kimliği iletebilirsiniz. isteğinde bulunabilirsiniz. API, sağlanan yer kimlikleri üzerinde yol tutturma işlemi yapmaz. Yanıt, istekteki her yer kimliği için bir hız sınırı içerir.snapToRoads
veyanearestRoads
isteği gönderebilirsiniz bulmak için en iyi uygulamaları bulmanız gerekir. Daha sonra, bunlarıspeedLimits
isteği. Aşağıdaki örnekte, İki yer kimliğine sahipplaceId
parametresi:placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU
key
— Uygulamanızın API anahtarı. Sizin Her isteğe bir API anahtarı ekleyerek Roads API. Nasıl anahtar alacağınızı öğrenin.
İsteğe bağlı parametreler
units
— Hız sınırlarının kilometre veya mil cinsinden döndürülüp döndürülmeyeceği saat. Bu,KPH
veyaMPH
olarak ayarlanabilir. Varsayılan olarakKPH
değerine ayarlanır.
Yanıtlar
speedLimits
yanıtında aşağıdaki öğeler bulunabilir:
speedLimits
: Yol meta verileri dizisi. Her öğe şu alanları kullanın:placeId
: Bir yerin benzersiz tanımlayıcısıdır. Tüm yer kimlikleri döndürüldü işareti yol segmentlerine karşılık gelir.Roads APIspeedLimit
— Söz konusu yol segmenti için hız sınırı.units
—KPH
veyaMPH
değerini döndürür.
snappedPoints
— bir araya getirilen noktalar dizisi. Bu dizi mevcut yalnızca istek birpath
parametresi içeriyorsa. Her nokta şunlardan oluşur: aşağıdaki alanları doldurun:location
—latitude
velongitude
değerini içerir.originalIndex
: Karşılık gelen değeri gösteren bir tam sayı değiştirebilirsiniz. İstekteki her değer yanıttaki tutturulmuş değer. Bu değerler0
kaynağından dizine eklendiğinden4
üzerindenoriginalIndex
olan puan, 5.path
parametresine iletilen enlem/boylam.placeId
: Bir yerin benzersiz tanımlayıcısıdır. Tüm yer kimlikleri döndürüldü işareti yol segmentlerine karşılık gelir.Roads APIplaceId
, o yol segmentindeki hız sınırı uygulanır.
warning_message
: Kullanıcıların görebildiği uyarı içeren bir dize.
Yol kullanan örnek istek
Bu istek, hedefe en yakın her yol segmenti için hız sınırını alıyor Vasco da Gama'yı geçen bir yolda belirtilen enlem/boylam çiftleri Portekiz'in Lizbon şehrindeki bir köprüde yer alıyor.
İstek
https://roads.googleapis.com/v1/speedLimits?path=38.75807927603043,-9.03741754643809|38.6896537,-9.1770515|41.1399289,-8.6094075&key=YOUR_API_KEY
Yanıt
{ speedLimits: [ { placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE", speedLimit: 105, units: "KPH" }, { placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU", speedLimit: 70, units: "KPH" }, { placeId: "ChIJJ4vQRudkJA0RpednU70A-5M", speedLimit: 55, units: "KPH" } ], snappedPoints: [ { location: { latitude: 38.75807927603043, longitude: -9.037417546438084 }, originalIndex: 0, placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE" }, { location: { latitude: 38.689653701836896, longitude: -9.177051486847693 }, originalIndex: 1, placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU" }, { location: { latitude: 41.13993011767777, longitude: -8.609400794783655 }, originalIndex: 2, placeId: "ChIJJ4vQRudkJA0RpednU70A-5M" } ], warningMessage: "Input path is too sparse. You should provide a path where consecutive points are closer to each other. Refer to the 'path' parameter in Google Roads API documentation." }
Yukarıdaki yanıtta nokta azlığı ile ilgili uyarı mesajına dikkat edin. Şu durumda:
Rastgele noktalarda en yakın yol segmentleri için hız sınırları talep ediliyorsa,
şuradan alınan yer kimliklerini kullanarak speedLimits
işlevini çağırmalısınız:
Bunun yerine nearestRoads
uç noktası.
Yer kimliklerini kullanan örnek istek
Enlem/boylam çiftleri kullanmak yerine, her bir konum için boylamsal
yol segmentleri. Yol segmentleri için yer kimliklerini
snapToRoads
veya nearestRoads
istekleri. Yer kimliklerini ilettiğinizde API,
her bir yer kimliğinin temsil ettiği yol segmentinin hız sınırını döndürür. İlgili içeriği oluşturmak için kullanılan
API, sağlanan yer kimliklerine herhangi bir yol tutturma uygulamaz.
Aşağıdaki örnekte bazı yol segmentleri için hız sınırları istenmektedir Vasco da Gama köprüsünün üzerinden geçen, Portekiz'in Lizbon eyaletindeki
İstek
https://roads.googleapis.com/v1/speedLimits?placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU&placeId=ChIJJ4vQRudkJA0RpednU70A-5M&key=YOUR_API_KEY
Yanıt
{ "speedLimits": [ { placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE", speedLimit: 105, units: "KPH" }, { placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU", speedLimit: 70, units: "KPH" }, { placeId: "ChIJJ4vQRudkJA0RpednU70A-5M", speedLimit: 55, units: "KPH" } ] }
Kullanım önerileri
Hız Sınırı hizmetine yapılan çağrıların hacmini en aza indirmek için aşağıdakileri öneririz: öğelerinizin konumlarını 5 ila 15 dakikalık aralıklarla örneklemek (tam değeri öğenin hareket etme hızına bağlıdır). Bir öğe tek bir konum örneği yeterlidir (herhangi bir işlem için birden fazla çağrı).
Genel gecikmeyi en aza indirmek için Hız Sınırı hizmetini çağırmanızı öneririz. her seferinde API'yi çağırmak yerine veri topladıktan sonra konumu alındığından emin olun.
Hız sınırlarının bir kısmı veya tamamı neden eksik?
speedLimits
metriğinin eksik olmasının en yaygın nedeni hız sınırını istemektir
yol segmenti olmayan bir yer.
Yukarıdaki örnekte, kavramları göstermek için Vasco da Gama köprüsü kullanılmaktadır;
köprü, Rio Tejo üzerinden geçen E90 kara yolunu destekler. Köprü
kendisinin yer kimliği ChIJUzt97ZEwGQ0RM1JzQfqoDtU şeklindedir. Yolun ilk bölümü
yukarıdaki yanıt E90 yolunun bir parçasıdır ve şu yer kimliğine sahiptir:
ChIJX12duJAwGQ0Ra0d4Oi4jOGE. Örnek istekte, yolu
yer kimliğini içeriyorsa yanıtta yalnızca
köprünün yer kimliği olduğundan speedLimits
dizisinde iki hız sınırı
tek bir yol segmentini ifade etmez. Ayrıca,
yer kimlikleri yol segmentleri içinse, yanıt herhangi bir
kullanabilirsiniz.
Yer kimliklerini kullanarak hız sınırı isteğinde bulunurken her yer kimliğinin bulunduğundan emin olun.
farklı bir yer türü değil, bir yol segmenti anlamına gelir. Yer kimlikleri:
tek tek yol segmentleri en iyi şekilde snapToRoads
kullanılarak alınır
veya nearestRoads
istekleri. Bunların her ikisi de şuradan birden fazla yer kimliği döndürebilir:
yapabilirsiniz.