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

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

• Yalnızca Metin Arama (Yeni): Önceden tanımlanmış bir gezi rotası üzerindeki yerleri arayın.
• Metin Arama (Yeni) ve Yakında Arama (Yeni): Belirtilen bir rota başlangıç konumundan arama sonuçlarındaki her yere kadar olan rota özetini hesaplayın.
• Yalnızca Metin Arama (Yeni): Önceden tanımlanmış bir gezi rotası üzerindeki her yer için yönlendirme özetini hesaplayın.

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 yaya için rota hesaplayabilir.

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

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

Bir rota boyunca arama yapmak, arama sonuçlarını etkilemek için locationRestriction veya locationBias istek seçeneklerini kullanmaya benzer. locationRestriction görüntü alanı sınırları içinde kalan arama sonuçlarını döndürürken locationBias 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ı etkileyecek bir bölge belirtmenize olanak tanırken Metin Arama'daki rota üzerinde arama özelliği, arama sonuçlarını rotanın başlangıç noktasından varış noktasına kadar en az sapma süresine sahip olanları içerecek şekilde etkilemenize de olanak tanır. Çoklu çizgiyle birlikte locationBias veya locationRestriction kullanarak arama sonuçlarını yönlendirebilirsiniz.

Örneğin, Routes API'de ara nokta olarak adlandırılan başlangıçtan hedefe giden ve Routes API tarafından hesaplanan rotayı ele alalım:

Rota üzerinde arama yaptığınızda, arama sonuçlarında rotanın yakınında bulunan ve başlangıç noktasından varış noktasına en kısa sapma süresine sahip yerler öncelikli olarak gösterilir. Bu örnekte A, B ve C noktaları, arama tarafından döndürülen yerlerdir.

Yönlendirme özetini hesaplama

Metin Arama (Yeni) ve Yakında Arama (Yeni), yönlendirme özetini (yani süreyi ve mesafeyi) hesaplayabilir. Bu hesaplama, yanıttaki her bir yer için istekte belirtilen yönlendirme başlangıç konumuna göre yapılır. Yönlendirme başlangıcını belirttiğinizde yanıtta yalnızca aramayla eşleşen yerlerin listesi değil, aynı zamanda yönlendirme başlangıcından her bir yere olan seyahat süresi ve mesafe de yer alır.

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

Sonuçlardaki her yer için yanıtta, varsa yönlendirme başlangıcından yere kadar olan seyahat süresi ve mesafesi yer alır.

Not: Bu yalnızca yönlendirme bilgilerinin tahmini değeridir. Adım adım yol tarifleri de 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 mesafesi Routes API'deki TRAFFIC_UNAWARE seçeneği kullanılarak hesaplanır. İsteğe bağlı olarak, hesaplamalar sırasında canlı trafik koşullarını TRAFFIC_AWARE_OPTIMAL veya gecikmesi azaltılmış canlı trafik koşullarını TRAFFIC_AWARE dikkate almak için yönlendirme tercihlerini ayarlayabilirsiniz.

Not: TRAFFIC_AWARE ve TRAFFIC_OPTIMAL yalnızca DRIVE ve TWO_WHEELER ulaşım modları için geçerlidir. Yönlendirme tercihlerinden biri desteklenmeyen bir seyahat moduyla belirtilirse yönlendirme özeti hesaplamasında varsayılan olarak TRAFFIC_UNAWARE seçeneği kullanılı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. Bu sayede rota ve rota ayrıntıları, gerçek dünya koşullarını daha doğru yansıtır. Veri kalitesindeki bu artış yanıt gecikmesi pahasına gerçekleştiğinden, gecikmenin büyük bir kısmını azaltmak için performans optimizasyonları uygulanır. TRAFFIC_AWARE_OPTIMAL Yönlendirme tercihi ayarlandığında, rotalar trafik koşulları dikkate alınarak hesaplanır ancak performans optimizasyonu uygulanmaz. Bu modda sunucu, en uygun rotayı bulmak için yol ağında daha kapsamlı bir arama yapar.

Rotalar, etaplar ve ara noktalar hakkında

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

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

• Waypoint: Bir rotayı hesaplamak için en azından başlangıç ve hedef konumlarını belirtirsiniz. Bu konumları rotadaki ara noktalar olarak tanımlarsınız. Ara duraklar, başlangıç noktası ile varış noktası arasında rotanın geçmesini istediğiniz yerlerdir.

• Rota: Başlangıç ara noktasından başlayıp tüm ara noktalardan geçerek varış ara noktasına kadar olan yolculuğun tamamı. Rota bir veya daha fazla etaptan oluşur.

  Text Search'e bir rota iletirken Routes API tarafından döndürülen rotanın kodlanmış çoklu çizgisini iletirsiniz. Kodlanmış çoklu çizgi, rotanın çoklu çizgisini dize olarak temsil etmenizi sağlayan, enlem ve boylam noktalarının kodlanmış bir listesidir.

• Etap: Bir rotadaki bir ara noktadan rotadaki bir sonraki ara noktaya giden yol. Her bacak bir veya daha fazla ayrı adımdan oluşur.

  Bir rotada, her bir yol noktasından bir sonrakine giden yol için ayrı bir etap bulunur. Örneğin, rotada tek bir başlangıç noktası ve tek bir varış noktası varsa rota tek bir etaptan oluşur.

  Başlangıç ve varış noktasından sonra rotaya eklediğiniz her ek ara nokta için (ara ara nokta olarak adlandırılır) API ayrı bir etap ekler.

Rotalar ve rota hesaplama hakkında daha fazla bilgi için Routes API'ye bakın.

Rota üzerinde arama yaparak rota özetini hesaplama

Rota özeti hesaplamalarını rota boyunca arama ile birleştirebilirsiniz. Bu durumda, Metin Arama (Yeni) yanıttaki her yere seyahat süresini ve mesafeyi ve ardından her yerden rotanın son hedefine olan mesafeyi döndürür. Bu hesaplamayı, arama sonuçlarındaki bir yere gitmek için belirtilen rotadan saparsanız ve ardından nihai hedefe doğru devam ederseniz seyahat süresini ve mesafesini sağlayan bir hesaplama olarak düşünebilirsiniz.

Örneğin, başlangıçtan hedefe kadar olan ve Routes API tarafından hesaplanan aşağıdaki rotayı ele alalım. Bu rotayı, arama ölçütlerinizle birlikte Text Search (New) API'ye iletin.

Bu örnekte A konumu, Metin Arama (Yeni) hizmetinden gelen arama sonuçlarında döndürülen bir yerdir. Yanıtın her bir yeri için arama, iki ayaklı bir gezi olarak o yere gitmek için gereken süreyi ve mesafeyi içerir:

• İlk etapta, rotanın başlangıç noktasından yere kadar olan seyahat süresi ve mesafe yer alır. Bu örnekte, başlangıç noktasından A yerine.
• İkinci etapta, yerden rota hedefine olan seyahat süresi ve mesafesi yer alır. Bu örnekte, A'dan hedefe kadar.

Yanıtın içerdiği bilgilerden yararlanarak alternatif yolun süresini ve mesafesini hesaplayabilirsiniz. Burada:

• \(t_{OD}\) , başlangıç noktasından varış noktasına seyahat süresini, \(s_{OD}\) , başlangıç noktasından varış noktasına seyahat mesafesini gösterir.
• \(t_{OA}\) , başlangıç noktasından A'ya olan seyahat süresini; \(s_{OA}\) ise başlangıç noktasından A'ya olan seyahat mesafesini gösterir.
• \(t_{AD}\) , A noktasından varış noktasına seyahat süresidir; \(s_{AD}\) , A noktasından varış noktasına seyahat mesafesidir.

Alternatif yol süresi, orijinal yolculuk (başlangıç noktasından varış noktasına) ile yeni yolculuk (başlangıç noktasından varış noktasına A üzerinden) arasındaki süre farkıdır:

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

Ekstra mesafe, orijinal yolculuk (kalkış noktasından varış noktasına) ile yeni yolculuk (kalkış noktasından varış noktasına A üzerinden) arasındaki mesafe farkıdır:

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