Hız sınırları

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 veya placeId 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 bir placeId parametresi iletmelidir. Aşağıdaki örnek üç enlem/boylam çiftine sahip path 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ği gönderin. 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 veya nearestRoads 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 sahip placeId 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 veya MPH olarak ayarlanabilir. Varsayılan olarak KPH 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 API
    • speedLimit — Söz konusu yol segmenti için hız sınırı.
    • units — KPH veya MPH değerini döndürür.
  • snappedPoints — bir araya getirilen noktalar dizisi. Bu dizi mevcut yalnızca istek bir path parametresi içeriyorsa. Her nokta şunlardan oluşur: aşağıdaki alanları doldurun:
    • location — latitude ve longitude 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ğerler 0 kaynağından dizine eklendiğinden 4 üzerinden originalIndex 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 API placeId, 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.