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çenekte, önceden hesaplanmış rotayı Routes API'den Metin Arama (Yeni) 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ı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üresine sahip olanları 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 yol noktası olarak adlandırılan başlangıç noktasından Routes API tarafından hesaplanan hedefe giden rotayı ele alalım:

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 yer için yanıtta, seyahat süresi ve varsa rota başlangıcından yere olan mesafe yer alır.

Not: Bu, yalnızca yönlendirme bilgilerine dair 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.

Seyahat süresi ve mesafe varsayılan olarak 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 belirlediğinizde rotalar, trafik koşulları dikkate alınarak hesaplanır. Sonuç olarak 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 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 uygun 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ı birkaç bileşen oluşturur:

Rotalar aşağıdaki bileşenlerden oluşur:

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

• Rota: Başlangıç ara noktasından, tüm ara ara noktalardan geçerek hedef ara noktasına kadar olan 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ış bir poli çizgi, rotanın poli çizgisini dize olarak temsil etmenize olanak tanıyan, 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 nihai hedefe devam ederseniz seyahat süresi ve mesafesi sunmak olarak düşünebilirsiniz.

Örneğin, Routes API tarafından hesaplanan, kaynaktan hedefe giden aşağıdaki rotayı ele alalım. 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 gezi 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ıçtan A yerine
• İ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 kadar olan seyahat süresi, \(s_{OD}\) ise başlangıç noktasından varış noktasına kadar olan seyahat mesafesidir.
• \(t_{OA}\) , başlangıç noktasından A noktasına seyahat süresi, \(s_{OA}\) ise başlangıç noktasından A noktasına seyahat mesafesidir.
• \(t_{AD}\) , A noktasından hedefe olan seyahat süresi, \(s_{AD}\) ise A noktasından hedefe olan seyahat mesafesidir.

Dönüş yolu süresi, orijinal seyahat (başlangıç noktasından hedefe) ile yeni seyahat (başlangıç noktasından hedefe A aracılığıyla) arasındaki süre farkıdır:

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

Dönüş yolu mesafesi, orijinal seyahat (kalkış noktasından varış noktasına) ile yeni seyahat (kalkış noktasından varış noktasına A aracılığıyla) arasındaki mesafe farkıdır:

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