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

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

• Yalnızca Text Search (New): Ö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 bir yere giden rota özetini hesaplayın.
• Yalnızca Metin Arama (Yeni): Önceden tanımlanmış bir gezi rotası boyunca her yer için rota ö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; otomobil, bisiklet, iki tekerlekli araç, toplu taşıma sistemi veya yaya için rota hesaplayabilir.

Text Search (New), hesaplanan bu rotayı kullanarak rota boyunca arama yapmanı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.

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çindeki 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 Text Search'teki 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 tarafından hesaplanan, başlangıç noktasından (Routes API'de ara nokta olarak adlandırılır) varış noktasına giden rotayı ele alalım:

Rota boyunca arama yaptığınızda, arama sonuçları, başlangıç noktasından varış noktasına en az sapma süresiyle rota yakınındaki yerleri döndürmeye yöneliktir. Bu örnekte A, B ve C noktaları, arama sonucunda döndürülen yerlerdir.

Rota hesaplama özeti

Metin Arama (Yeni) ve Yakında Arama (Yeni), istekte belirtilen rota başlangıç konumuna göre yanıttaki her yer için rota özetini (yani süreyi ve mesafeyi) hesaplayabilir. Rota kaynağını belirttiğinizde yanıt, yalnızca aramayla eşleşen yerlerin listesini değil, aynı zamanda rota kaynağından her bir yere olan seyahat süresini ve mesafeyi de 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ıt, varsa rotanın başlangıç noktasından yere olan seyahat süresini ve mesafeyi içerir.

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 alacak rota tercihlerini ayarlayabilirsiniz.

Rotalar, ayaklar ve ara noktalar hakkında

Routes API tarafından hesaplanan bir rota birkaç bileşenden oluşur:

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

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

• Rota: Başlangıç noktasından ara noktalar üzerinden varış noktasına kadar olan tüm seyahat. Rota, bir veya daha fazla ayaktan 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 etmenize olanak tanıyan, kodlanmış bir enlem ve boylam noktaları listesidir.

• Ayak: Rotadaki bir ara noktadan rotadaki bir sonraki ara noktaya giden yol. Her ayak, bir veya daha fazla ayrı adımdan oluşur.

  Bir rota, her bir ara noktadan bir sonrakine giden yol için ayrı bir ayak içerir. Örneğin, rota tek bir başlangıç noktası ara noktası ve tek bir varış noktası ara noktası içeriyorsa rota tek bir ayak içerir.

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

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

Rota boyunca arama yaparak rota özetini hesaplama

Rota özeti hesaplamalarını rota boyunca arama ile birleştirebilirsiniz. Bu durumda Metin Arama (Yeni), yanıttaki her bir yere ve ardından her bir yerden rotanın son 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 son hedefe devam etmeniz durumunda seyahat süresi ve mesafesi sağlama olarak düşünebilirsiniz.

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

Bu örnekte, A konumu, Text Search (New) arama sonuçlarında döndürülen bir yerdir. Yanıttaki her yer için arama, iki ayaklı bir yolculuk olarak o yere sapmak için gereken süreyi ve mesafeyi içerir:

• İlk etap, rotanın başlangıç noktasından yere olan seyahat süresini ve mesafeyi içerir. Bu örnekte, başlangıç noktasından A yerine.
• İkinci ayak, yer ile rota hedefi arasındaki seyahat süresini ve mesafeyi içerir. Bu örnekte, A'dan hedefe.

Yanıttaki bilgilerden sapma süresini ve mesafesini hesaplayabilirsiniz. Burada:

• \(t_{OD}\) , başlangıç noktasından varış noktasına kadar olan gezi süresidir, \(s_{OD}\) , başlangıç noktasından varış noktasına kadar olan gezi mesafesidir.
• \(t_{OA}\) , başlangıç noktasından A'ya gezi süresidir; \(s_{OA}\) , başlangıç noktasından A'ya gezi mesafesidir
• \(t_{AD}\) , A noktasından varış noktasına kadar olan gezi süresidir; \(s_{AD}\) , A noktasından varış noktasına kadar olan gezi mesafesidir.

Yol değiştirme süresi, orijinal gezi (başlangıç noktasından varış noktasına) ile yeni gezi (başlangıç noktasından A üzerinden varış noktasına) arasındaki süre farkıdır:

Sapma mesafesi, orijinal gezi (başlangıç noktasından varış noktasına) ile yeni gezi (başlangıç noktasından A üzerinden varış noktasına) arasındaki mesafe farkıdır: