Rota üzerindeki aramalara genel bakış

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

• Yalnızca Metin Arama (Yeni): Önceden tanımlanmış bir gezideki yerleri arama yol gösterir.
• 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): Her yer için rota özetini hesaplayın önceden tanımlanmış bir gezi rotası üzerindedir.

Rota üzerinde arama

İ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ı geçersiniz Routes API'den Text Search (Yeni) isteğine. Yanıt, arama ölçütleriyle eşleşen ve belirtilen rotanın yakınında bulunan yerleri içerir.

Rota üzerinde arama yapmak, locationRestriction veya Arama sonuçlarında yanlılık oluşturmak için locationBias istek seçenekleri. 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, başlangıç noktası olarak adlandırılan rotayı Routes API'deki Routes tarafından hesaplanan hedefe giden ara nokta API:

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ı aramada döndürülen yerlerdir yanıt:

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. Asıl adım adım yol tarifi de dahil olmak üzere, ayrıntılar için Rotalar API.

Varsayılan olarak, seyahat süresi ve mesafe TRAFFIC_UNAWARE kullanılarak hesaplanır seçeneğini belirleyin. İsteğe bağlı olarak, canlı trafik koşulları TRAFFIC_AWARE_OPTIMAL veya gecikme azaltılmış canlı trafik koşulları TRAFFIC_AWARE hesaba katar.

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 bölge olması durumunda API, boş yönlendirme özeti.

TRAFFIC_AWARE Rota tercihini belirlediğinizde rotalar, trafik koşulları dikkate alınarak hesaplanır. Farklı Sonuç olarak, rota ve rota ayrıntıları gerçek dünyayı daha doğru koşullar. Veri kalitesindeki bu artış yanıt verme pahasına, söz konusu olduğunda, gecikmenin çoğunu 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ğını daha kapsamlı şekilde arayın.

Rotalar, ayaklar ve ara noktalar hakkında

Routes API'nin hesapladığı rota, çeşitli bileşenlerden oluşur:

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

• Ara nokta: Rotayı hesaplamak için en azından konumları belirtirsiniz. varış ve varış noktası seçin. Bu konumları bir sonraki sayfada ara nokta olarak yol gösterir. Ara ara noktalar, başlangıç noktası ile geçmesini istediğiniz hedeftir.

• 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 geçirirken rotanın kodlanmış yol tarifini Routes API tarafından döndürülen çoklu çizgi. Kodlanmış bir poli çizgi, rotanın poli çizgisini dize olarak temsil etmenize olanak tanıyan, enlem ve boylam noktalarının kodlanmış bir listesidir.

• Aşak: Rotadaki bir ara noktadan sonraki ara noktaya kadar olan yol yol gösterir. Her ayak, bir veya daha fazla ayrı adımdan oluşur.

  Rotada her bir ara noktadan diğerine giden yol için ayrı bir ayak bulunur. Örneğin, rota tek bir başlangıç ve tek bir varış noktası içeriyorsa tek bir bacağı vardır.

  Güzergaha başlangıç ve bitiş noktalarından sonra eklediğiniz her ek ara nokta için ara ara nokta adı verilen bir hedefe yönelik olarak API ayrı bir ayak ekler.

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

Güzergah özeti hesaplamalarını rota boyunca 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ı, bir seyahat projesinin bir hedefe gitmek için belirtilen rotadan sapmanız halinde süre ve mesafe yer arama sonuçlarında görebilir ve ardından son hedefe doğru devam edebilirsiniz.

Örneğin, Routes API tarafından hesaplanan, kaynaktan hedefe giden aşağıdaki rotayı ele alalım. Bu rotayı Text Search (Yeni) API'ye geçirin dikkat edin.

Bu örnekte, A konumu Metin'den arama sonuçlarında döndürülen bir yerdir Ara (Yeni) seçeneğini belirleyin. Arama, yanıttaki her bir yerle ilgili olarak ve iki ayakla seyahat sırasında söz konusu yere güzergâh üzerinden sapmak için gereken mesafe:

• İ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 ayak, seyahat süresini ve place öğesini hedef rotasına ekleyin. Bu örnekte, A'dan seçeceğiz.

Yanıttaki bilgilerden yola çıkarak takma yol süresini hesaplayabilirsiniz süre ve mesafe olarak ayarlayın:

• \(t_{OD}\) , kalkış noktasından varış noktasına kadar olan seyahat süresidir. \(s_{OD}\) , kalkış noktası ile varış noktası arasındaki seyahat mesafesidir.
• \(t_{OA}\) , kalkış noktası ile A arasındaki seyahat süresidir; \(s_{OA}\) kalkış ile A arasındaki seyahat mesafesi
• \(t_{AD}\) , A'dan varış noktasına seyahat süresidir; \(s_{AD}\) , A ile varış noktası arasındaki 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} $$

Tali güzergah mesafesi, orijinal seyahat arasındaki mesafe farkıdır (kalkış noktasından varış noktasına) ve yeni gezi (kalkış noktasından varış noktasına) A aracılığıyla hedefi belirtir):

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