Isochrones API SSS

Gelen "işe gidiş" eş zamanlılık eğrisini (bir varış noktasına gidiş) giden eş zamanlılık eğrisine (bir başlangıç noktasından geliş) kıyasla nasıl hesaplarım?

Hem gelen hem de giden hesaplamalar, travelDirection (travel_direction) parametresi kullanılarak v1 API'de desteklenir:

  • FROM (Giden): Belirtilen süre içinde başlangıç noktasından from ulaşılabilecek alanı hesaplar. Bu, doğrudan teslimat bölgeleri veya hizmet kapsamı gibi kullanım alanları için uygundur.

  • TO (Gelen): Belirtilen süre içinde başlangıç noktasına to seyahat edebileceğiniz alanı hesaplar. Bu, işe gidiş geliş özellikleri veya merkezi bir ofis ya da toplu taşıma merkezi çevresindeki hizmet bölgelerini belirleme gibi uygulamalar için uygundur.

Dört seyahat modu (DRIVE, TWO_WHEELER, BICYCLE ve WALK) arasındaki farklar nelerdir?

Her modun kendi yol ağı erişim kuralları, dönüş maliyetleri ve hız modeli vardır:

  • DRIVE: 3.600 saniyeye (60 dakika) kadar, yayınlanan veya serbest akış hızlarını ya da canlı trafik hızlarını (TRAFFIC_AWARE) kullanarak araçla gidilebilen yolları geçer.
  • TWO_WHEELER: Yüksek hızlı yollarda DRIVE değerinden daha düşük modellenmiş hızlara sahip, motorlu iki tekerlekli araçların erişebileceği yollardan geçer ve isteğe bağlı olarak TRAFFIC_AWARE rotası oluşturur (3.600 saniyeye veya 60 dakikaya kadar). Sonuç olarak, yüksek hızlı otoyollarda TWO_WHEELER eş zamanlılık BICYCLE değerinden büyük ancak DRIVE değerinden küçüktür.
  • BICYCLE: Bisikletle erişilebilen sokakları, bisiklet yollarını ve yolları, yol türüne ve eğime göre ayarlanmış hızlarla (otoyollar ve otobanlar hariç) 7.200 saniyeye (120 dakika) kadar kat eder.
  • WALK: Yaya kaldırımları, patikalar ve sokaklarda eğime göre ayarlanmış yürüme hızıyla (tek yönlü araç kısıtlamaları dikkate alınmaz) 7.200 saniyeye (120 dakika) kadar olan mesafeyi kat eder.

Isochrones API, feribotları veya su geçişlerini içerir mi?

Hayır. Isochrones API yalnızca yol, köprü, tünel ve patika bağlantılarını kullanır. Feribot rotaları ve su yolu geçişleri tüm seyahat modlarında hariç tutulur. Yalnızca feribotla ulaşılabilen adalar veya yarımadalar, ana karadan oluşturulan bir eş zamanlılık haritasına dahil edilmez.

Döndürülen poligon bazen bloklu görünebilir veya özellikle daha uzun süreler için pürüzlü, basamaklı kenarlara sahip olabilir. Ayrıntı düzeyi neden değişiyor?

Isochrones API, mekansal hesaplama kılavuzunun çözünürlüğünü, istenen travel_duration ve travel_mode değerlerine göre dinamik olarak ayarlar:

  • Daha kısa süreler: Toplam alan küçük olduğundan ve ayrıntılı bir sınır oluşturduğundan son derece hassas, yüksek çözünürlüklü bir ızgara kullanın.
  • Daha uzun süreler: Ciddi gecikmelere neden olmadan geniş coğrafi alanı verimli bir şekilde kapsamak için daha kaba, daha düşük çözünürlüklü bir ızgaraya geçiş yapın.

Süreden bağımsız olarak belirli ve tutarlı bir ayrıntı düzeyi gerekiyorsa isteğe bağlı polygon_fidelity parametresini HIGH, MEDIUM veya LOW olarak ayarlayabilirsiniz.

Park, göl veya büyük bir sanayi tesisi içindeki bir koordinat için eş zamanlılık isteğinde bulunulduğunda neden bazen "Bulunamadı" hatası döndürülüyor?

Isochrones API, yolları ve patikaları kullanarak seyahat sürelerini hesaplar. İstediğiniz başlangıç koordinatları tanınan bir yolda bulunmuyorsa API, hesaplamaya başlamadan önce noktayı en yakın uyumlu segmente "sabitlemelidir".

Her seyahat modunun maksimum tutturma mesafesi yaklaşık 200 metre veya daha azdır. WALK ve BICYCLE, DRIVE ve TWO_WHEELER'ye kıyasla daha kısa mesafeler kullanır. DRIVE ve TWO_WHEELER ise yalnızca yayalara açık yolları yok sayar.

Başlangıç koordinatınız geçerli ve moda uyumlu bir yol segmentinden bu mesafeden daha uzaktaysa tutturma işlemi başarısız olur ve API bir NOT_FOUND hatası döndürür. Bu sorunu çözmek için koordinatlarınızın herkese açık bir sokağa veya yola yakın olduğundan emin olun.

Yürüyüş veya bisiklet için trafiğe duyarlı rota isteğinde bulunduğumda neden hata alıyorum?

Canlı trafik koşulları (TRAFFIC_AWARE), DRIVE ve TWO_WHEELER seyahat modları için desteklenir. routingPreference, TRAFFIC_AWARE olarak ayarlanmışken WALK veya BICYCLE için eş zamanlılık istemeye çalışırsanız API, 400 INVALID_ARGUMENT hatası döndürür.

GeoJSON yanıtını haritamda oluşturduğumda şekil yanlış yerde gösteriliyor, bozuk görünüyor veya oluşturulamıyor. Bunun nedeni nedir?

Bu durum neredeyse her zaman koordinat sırası uyuşmazlığından kaynaklanır.

Isochrones API, GeoJSON standardına (RFC 7946) uygun olarak koordinatları [longitude, latitude] sırasıyla döndürür. Ancak birçok harita SDK'sı ve özel geometri nesnesi, koordinatların [latitude, longitude] sırasıyla girilmesini bekler.

Harita oluşturma işleminiz yanlışsa harita SDK'nızın GeoJSON'u nasıl işlediğini kontrol edin:

  • Google Maps JavaScript API: Veri katmanını (map.data.addGeoJson()) kullanıyorsanız bu sıra yerel olarak işlenir ve herhangi bir işlem yapmanız gerekmez.
  • Özel nesneler veya diğer SDK'lar: Yanıtı manuel olarak LatLng nesnelerine ayrıştırıyorsanız oluşturma işleminden önce GeoJSON yükündeki koordinatlar arasında gezinmeniz ve [lng, lat] değerlerini [lat, lng] çiftlerine dönüştürmeniz gerekir.

Eş zamanlı poligonumun içinde neden boş "delikler" var ve bunun yerine düz bir şekil elde edebilir miyim?

Boşluklar, zaman sınırı içinde ulaşılabilir yolun olmadığı alanları temsil eder. Bu durum; büyük ormanların, su kütlelerinin, havaalanlarının veya araçların ya da yayaların giremediği özel mülklerin bulunduğu bölgelerde yaygındır.

Harici v1 API, boşlukları otomatik olarak kaldırmak için bir parametre sunmaz. Uygulamanızın kesin bir sınır gerektirmesi durumunda (ör. çokgen içinde nokta kapsama kontrolleri yapmak için) şunları yapabilirsiniz:

  • Algoritmanın bu dahili boşlukları genelleştirmesini ve birleştirmesini teşvik etmek için polygon_fidelity parametresini MEDIUM veya LOW olarak ayarlayın.
  • GeoJSON'u ayrıştırmak ve yalnızca ilk koordinat halkasını (dış kabuk) ayıklamak için istemci tarafı bir GIS kitaplığı (ör. Turf.js) kullanın. Sonraki iç halkaları (delikler) silin.

Arka uç mekansal analizi için enable_smoothing seçeneğini etkinleştirmeli miyim?

Hayır. enable_smoothing parametresi tamamen görsel estetik için tasarlanmıştır. Alttaki hesaplama kılavuzunun keskin köşelerini yuvarlayarak şeklin haritada doğal görünmesini sağlar.

Yumuşatma, köşeleri değiştirdiği ve sınırları biraz kaydırdığı için hassas mekansal analizlerde önerilmez. Arka uç hesaplamaları, veritabanı sorguları veya çokgen içindeki nokta testleri için enable_smoothing değerini false olarak ayarlayarak matematiksel olarak hassas şekilde hesaplanan sınırı kullandığınızdan emin olun.