Rota üzerinde arama özelliğine genel bakış

Rota boyunca arama özellikleri aşağıdaki Places (Yeni) API'lerinde kullanılabilir:

• Yalnızca metin arama (yeni): Önceden tanımlanmış bir gezi rotası üzerinde yer arayın.
• Metin Arama (Yeni) ve Yakındakiler Arama (Yeni): Belirtilen bir yol planlama başlangıç konumundan arama sonuçlarındaki her yere giden yol planlama özetini hesaplayın.
• Yalnızca metin arama (yeni): Önceden tanımlanmış bir seyahat rotası boyunca her bir yer için yol özetini hesaplar.

Rota üzerinde arama yapma

İki konum arasındaki seyahat rotasını hesaplamak için Routes API'yi kullanırsınız. Routes API; araba, bisiklet, iki tekerlekli araç, toplu taşıma sistemi veya yürüyüş için rota hesaplayabilir.

Not: Toplu taşıma sistemi rotaları, Places API tarafından desteklenmez.

Metin Arama (Yeni), bir rota boyunca arama yapmak için bu hesaplanmış rotayı kullanmanıza olanak tanır. Bu seçenekle, önceden hesaplanmış rotayı Routes API'den Metin Arama (Yeni) isteğine iletirsiniz. Daha sonra yanıt, arama ölçütleriyle eşleşen ve ayrıca belirtilen rotanın yakınında bulunan yerleri içerir.

Rota boyunca arama yapmak, arama sonuçlarında yanlılık sağlamak için locationRestriction veya locationBias istek seçeneklerini kullanmaya benzer. locationRestriction, görüntü alanı sınırlarına giren arama sonuçlarını döndürür. locationBias ise görüntü alanının dışındaki arama sonuçlarını döndürebilir. Ancak locationBias ve locationRestriction seçenekleri, arama sonuçlarını belirli bir bölgeye göre yönlendirmenize olanak tanır. Metin aramadaki rota üzerinde arama özelliği ise arama sonuçlarını, rotanın başlangıç noktasından varış noktasına kadar en az yan yol süresi olan sonuçları içerecek şekilde yönlendirmenize olanak tanır. Poli çizgiyle birlikte locationBias veya locationRestriction kullanarak arama sonuçlarına önyargı uygulayabilirsiniz.

Örneğin, Routes API'de ara nokta olarak adlandırılan kaynaktan Routes API tarafından hesaplanan hedefe giden rotayı inceleyin:

Rota boyunca arama yaptığınızda arama, başlangıç noktasından varış noktasına en az sapma süresi olan rotaya yakın yerleri döndürecek şekilde yönlendirilir. Bu örnekte A, B ve C noktaları arama sonucunda döndürülen yerlerdir.

Yönlendirme özetini hesaplama

Metin Arama (Yeni) ve Yakındakiler Arama (Yeni), istekteki belirtilen yönlendirme başlangıç konumuna göre yanıttaki her bir yere ilişkin yönlendirme özetini (yani süre ve mesafeyi) hesaplayabilir. Yönlendirme başlangıç noktasını belirttiğinizde yanıt, aramayla eşleşen yerlerin listesini ve ayrıca yönlendirme başlangıç noktasından her bir yere olan seyahat süresini ve mesafeyi içerir.

Aşağıdaki resimde A, B ve C noktaları, arama yanıtında döndürülen yerlerdir:

Sonuçlardaki her yerle ilgili yanıt, seyahat süresini ve rotanın başlangıç noktasından yere (varsa) mesafeyi içerir.

Not: Bu yalnızca yönlendirme bilgilerine ilişkin bir tahmindir. Adım adım yol tarifleri dahil olmak üzere gerçek rota ayrıntılarını almak için Routes API'yi kullanın.

Varsayılan olarak, seyahat süresi ve mesafe, Routes API'deki TRAFFIC_UNAWARE seçeneği kullanılarak hesaplanır. İsteğe bağlı olarak, yönlendirme tercihlerini hesaplamalar sırasında canlı trafik koşullarını TRAFFIC_AWARE_OPTIMAL veya gecikmesi azaltılmış canlı trafik koşullarını TRAFFIC_AWARE dikkate alacak şekilde ayarlayabilirsiniz.

Not: TRAFFIC_AWARE ve TRAFFIC_OPTIMAL yalnızca DRIVE ve TWO_WHEELER seyahat modları için geçerlidir. Yönlendirme tercihlerinden biri desteklenmeyen bir seyahat moduyla belirtilirse yönlendirme özeti hesaplaması varsayılan olarak TRAFFIC_UNAWARE seçeneğini kullanır. TWO_WHEELER, desteklenmeyen bir bölgede belirtilirse API boş bir yönlendirme özeti döndürür.

TRAFFIC_AWARE rota tercihini ayarladığınızda rotalar, trafik koşulları dikkate alınarak hesaplanır. Sonuç olarak, rota ve rota ayrıntıları gerçek dünyadaki koşulları daha doğru şekilde yansıtır. Veri kalitesindeki bu artış, yanıt gecikmesi pahasına elde edildiğinden gecikmenin büyük bir kısmını azaltmak için performans optimizasyonları uygulanır. TRAFFIC_AWARE_OPTIMAL yönlendirme tercihini belirlediğinizde yollar trafik koşulları dikkate alınarak hesaplanır ancak performans optimizasyonu uygulanmaz. Bu modda sunucu, en iyi rotayı bulmak için yol ağında daha kapsamlı bir arama yapar.

Rotalar, bölümler ve ara noktalar hakkında

Rotalar API'si tarafından hesaplanan bir rotayı oluşturan çeşitli bileşenler vardır:

Bir rota aşağıdaki bileşenlerden oluşur:

• Waypoint: Rotayı hesaplamak için en azından kalkış ve varış noktalarını belirtirsiniz. Bu konumları rotadaki yol üstü işaretleri olarak tanımlarsınız. Ara ara noktalar, başlangıç ve hedef arasında rotanın geçmesini istediğiniz konumlardır.

• Rota: Kalkış ara noktasından herhangi bir ara ara nokta üzerinden hedef ara noktaya kadar tüm seyahatin tamamı. Rotalar bir veya daha fazla ayaktan oluşur.

  Metin Arama'ya bir rota gönderirken Routes API tarafından döndürülen rotanın kodlanmış poli çizgisini gönderirsiniz. Kodlanmış çoklu çizgi, rotanın çoklu çizgisini bir dize olarak temsil edebilmenizi sağlayan, enlem ve boylam noktalarının kodlanmış bir listesidir.

• Adım: Bir rotadaki bir yol noktasından rotadaki sonraki yol noktasına giden yol. Her ayak, bir veya daha fazla ayrı adımdan oluşur.

  Rotalar, her bir yol noktasından sonrakine giden yol için ayrı bir ayak içerir. Örneğin, rota tek bir başlangıç ve tek bir varış noktası içeriyorsa tek bir bacağı vardır.

  API, başlangıç ve varış noktasından sonra rotaya eklediğiniz her ek yol

Rotalar ve rota hesaplama hakkında daha fazla bilgi için Rota API'si bölümüne bakın.

Rota üzerinde arama yaparak yönlendirme özetini hesaplama

Yol planlama özeti hesaplamalarını rota üzerinde arama ile birleştirebilirsiniz. Bu durumda Metin Arama (Yeni), yanıttaki her bir konuma ve ardından her bir konumdan rotanın nihai varış noktasına olan seyahat süresini ve mesafeyi döndürür. Bu hesaplamayı, arama sonuçlarındaki bir yere gitmek için belirtilen rotadan sapıp ardından nihai hedefe devam ederseniz seyahat süresi ve mesafesi sağladığını düşünün.

Örneğin, kaynaktan hedefe giden aşağıdaki rotayı Routes API tarafından hesaplandığı şekliyle göz önünde bulundurun. Bu rotayı, arama ölçütlerinizle birlikte Text Search (Yeni) API'ye iletin.

Bu örnekte A konumu, Metin Arama (Yeni)'den arama sonuçlarında döndürülen bir yerdir. Yanıttaki her yer için arama, iki aşamalı bir yolculuk olarak bu yere gitmek için gereken süreyi ve mesafeyi içerir:

• İlk bölüm, seyahat süresini ve rotanın başlangıç noktasından yer arasındaki mesafeyi içerir. Bu örnekte, başlangıç noktasından A konumuna
• İkinci etap, yer ile rotanın hedef noktası arasındaki seyahat süresini ve mesafeyi içerir. Bu örnekte A noktasından hedefe

Yanıttaki bilgilerden dönüş süresini ve mesafesini hesaplayabilirsiniz. Burada:

• \(t_{OD}\) , başlangıç noktasından varış noktasına olan seyahat süresi, \(s_{OD}\) , başlangıç noktasından varış noktasına olan seyahat mesafesidir.
• \(t_{OA}\) , kalkış noktası ile A arasındaki seyahat süresidir; \(s_{OA}\) kalkış noktası ile A arasındaki seyahat mesafesidir.
• \(t_{AD}\) , A noktasından hedefe olan seyahat süresi, \(s_{AD}\) ise A noktasından hedefe olan seyahat mesafesidir.

Tali tur süresi, orijinal seyahat (kalkış noktasından varış noktasına) yeni gezi (kalkış noktasından hedefe ve A noktasına kadar) arasındaki süre farkıdır:

$$ t_{detour} = t_{OA} + t_{AD} - t_{OD} $$

Tali güzergah mesafesi, orijinal seyahat (kalkış noktasından varış noktasına) yeni gezi (kalkış noktasından hedefe ve A noktasına kadar) arasındaki mesafe farkıdır:

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$