Isochrones API'si için en iyi uygulamalar

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: Çözünürlük. Ulaşılabilir alanı hesaplamak için kullanılan temel ızgara hücrelerinin (S2 hücreleri) 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ğının seyrek olduğu yerlerde boş alanlar veya "delikler" oluşabilir.
    • Varsayılan: Belirtilmemişse hizmet, istenen seyahat süresine göre doğruluğu dinamik olarak seçer.
  • enable_smoothing: Estetik. Doğruluk tarafından tanımlanan ızgara hücrelerinin keskin kenarlarının yuvarlatılıp yuvarlatılmayacağını kontrol eder.
    • false (Ham): Tam geometrik hesaplamayı döndürür. Kenarlar, ızgara hücrelerini yansıtacak şekilde tırtıklı veya kademeli görünür. Sıkı nokta-çokgen testleri gibi analitik doğruluk için idealdir.
    • 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.

Etkileşim şekli: Fidelity, yumuşatma algoritmasının temel aldığı temel ayrıntıyı belirler.

  • Yüksek Doğruluk + Yumuşatma: Yol sonlarını yakından takip eden, ayrıntılı ve doğal görünümlü bir şekil oluşturur.
  • Düşük Doğruluk + Yumuşatma: Geniş ve genelleştirilmiş bir "blob" şekli oluşturur.

Yük boyutu ve oluşturma

Büyük izokronlar binlerce koordinat içerebilir ve yükler 300 ila 500 kilobayt arasında olabilir.

  • Bant genişliği: Maksimum süreli isteklerde JSON yanıt boyutunun önemli olduğunu unutmayın.
  • Oluşturma: Çok ayrıntılı poligonların oluşturulması performansı etkiler. Görüntüleme için köşe sayısını azaltmak üzere enable_smoothing parametresini veya istemci tarafı basitleştirme kitaplıklarını kullanabilirsiniz.

Hata işleme

5xx sunucu hataları için eksponansiyel geri yüklemeyle yeniden deneme mantığını uygulayın. Ancak, parametrelerinizi değiştirmeden 4xx istemci hatalarını yeniden denemeyin:

  • INVALID_ARGUMENT (400): Sürenizin pozitif olduğundan ve seçilen modun sınırları içinde olduğundan emin olun. Bu sınır, DRIVE için en fazla 3.600 saniye, diğer modlar için ise 7.200 saniyedir.
  • NOT_FOUND (404): Başlangıç noktası bir yola tutturulamadı. Koordinatı bilinen bir sokağa yaklaştırmayı veya bölgenin desteklendiğinden emin olmayı deneyin.