Temel kavramlar

Eşzamanlılık eğrisi oluşturmak için API'ye bir kalkış noktası, sürüş, bisiklete binme veya yürüyüş gibi bir ulaşım şekli ve bir zaman sınırı sağlayın. Ayrıca yönlendirme tercihlerini ve sonuçta elde edilen poligonun görsel görünümünü de ayarlayabilirsiniz.

Zaman ufku

Hizmete sağladığınız birincil kısıtlama travel_duration'dır. Bu, hesaplamanın zaman aralığını tanımlar.

  • Maksimum süre: API, DRIVE modu için maksimum 3.600 saniye (1 saat), WALK ve BICYCLE modları için ise 7.200 saniye (2 saat) seyahat süresini destekler.
  • Performans: Hesaplama süresi, istenen süreye ve seçilen seyahat şekline göre değişir. Bir saatlik sürüş izokronu, bir saatlik yürüme izokronuna kıyasla önemli ölçüde daha geniş bir coğrafi alanı ve yol ağını kapsar. Bu durum, sürüş isteğinin daha yüksek gecikmeyle sonuçlanmasına neden olur.

Başlangıç noktaları ve yola tutturma

İzokronun başlangıç noktasını iki şekilde belirtebilirsiniz:

  • Koordinatlar: Enlem ve boylam çifti (location).
  • Yer kimlikleri: Google Haritalar'daki belirli bir yerin benzersiz tanımlayıcısıdır (place). Bir yer kimliği sağladığınızda hizmet, başlangıç noktası olarak söz konusu yerin ağırlık merkezini kullanır. API'nin, kaynak adının places/ChIJ... gibi bir biçimde olmasını beklediğini unutmayın. Yer kimlikleri hakkında daha fazla bilgi için Yer kimlikleri başlıklı makaleyi inceleyin.

Giriş yönteminden bağımsız olarak, API, yol üzerinde olmayan (ör. park veya bina içinde) bir noktadan seyahat sürelerini hesaplamaz. Bu durumu ele almak için hizmet, yol tutturma özelliğini kullanır. Yol tutturma özelliğinin aşağıdaki özellikleri vardır:

  • Akıllı tutturma: Hizmet, başlangıç noktanızı en yakın geçilebilir yol segmentine tutturmaya çalışır.
  • Mod farkındalığı: Yakalama mantığı, travel_mode dikkate alır. DRIVE isteğinde bulunursanız API, yalnızca yayalara açık yolları yoksayar ve en yakın sürüşe uygun sokağı arar. WALK isteğinde bulunursanız API, yürünebilir yollara ve kaldırımlara öncelik verir.
  • Hata durumları: API, başlangıç noktanızın yaklaşık 100 metre yakınında uygun bir yol segmenti bulamazsa 404 NOT_FOUND hatası döndürür. Bu durum genellikle noktanın yol ağından çok uzak olduğunu veya harita verilerinin istenen ulaşım modunu desteklemediği bir bölgede olduğunu gösterir.

Trafik farkındalığı

Trafik verilerinin oluşturulan poligonu nasıl etkileyeceğini routing_preference parametresiyle kontrol edin:

  • TRAFFIC_UNAWARE (Varsayılan): Eşzamanlılık poligonunu oluşturmak için hız sınırlarını ve yol hiyerarşisini kullanır. Bu, günün saatine göre değişmeyen deterministik bir şekil oluşturur. Bu parametre, genel analiz veya temel senaryo planlaması için idealdir.
  • TRAFFIC_AWARE: İsteğin yapıldığı sırada canlı veya tahmini trafik koşullarını kullanarak izokronlar hesaplar. Bu nedenle, ulaşılabilir alan trafik yoğunluğu sırasında küçülür, yoğun olmayan saatlerde ise genişler.

Düzeltme ve doğruluk

polygon_fidelity ve enable_smoothing parametrelerini kullanarak çıkış poligonlarının görünümünü ve hassasiyetini özelleştirebilirsiniz. Bu seçenekler birbirinden bağımsız olsa da son şekli belirlemek için birlikte çalışır.

  • polygon_fidelity: Ulaşılabilir alanı hesaplamak için kullanılan temel ızgara hücrelerinin boyutunu kontrol eder.

    • LOW: Daha büyük ızgara hücreleri kullanır. Boşluk bırakmadan geniş alanları kapsamak için idealdir. Bu sayede genel bir şekil elde edilir.
    • MEDIUM: Dengeli hassasiyet.
    • HIGH: Daha küçük ızgara hücreleri kullanır. Yol ağına daha iyi uyum sağlar ancak yol ağı seyrekse boş alanlar veya delikler oluşturabilir.
    • POLYGON_FIDELITY_UNSPECIFIED: Belirtilmemişse hizmet, istenen seyahat süresine göre doğruluğu dinamik olarak seçer.
      Yüksek, orta ve düşük poligon doğruluğu
      Yüksek, orta ve düşük poligon doğruluğu

  • enable_smoothing: Doğruluk tarafından tanımlanan ızgara hücrelerinin keskin kenarlarının yuvarlatılıp yuvarlatılmayacağını kontrol eder.

    • false (Ham): Varsayılan. Tam geometrik hesaplamayı döndürür. Kenarlar tırtıklı veya kademeli görünüyor. Sıkı nokta-çokgen testleri gibi analitik doğruluk için en iyisidir. Düzeltilmişten daha düşük gecikme süresi.
    • true (Düzleştirilmiş): Köşeleri yuvarlamak için bir son işleme algoritması uygular. Haritalarda görsel görüntüleme için en uygun seçenektir.
      Düzleştirme ile ve düzleştirme olmadan izokron
      Düzleştirme ile ve düzleştirme olmadan izokron