Yol Tarifi Hizmeti

Avrupa Ekonomik Alanı (AEA) geliştiricileri
Not: Sunucu tarafı kitaplıkları

Genel Bakış

DirectionsService nesnesini kullanarak (çeşitli ulaşım yöntemlerini kullanarak) yol tarifi hesaplayabilirsiniz. Bu nesne, yol tarifi isteklerini alan ve verimli bir rota döndüren Google Haritalar API Yol Tarifi Hizmeti ile iletişim kurar. Seyahat süresi, optimize edilen birincil faktördür ancak mesafe, dönüş sayısı ve daha birçok faktör de dikkate alınabilir. Bu yol tarifi sonuçlarını kendiniz işleyebilir veya bu sonuçları oluşturmak için DirectionsRenderer nesnesini kullanabilirsiniz.

Bir yol tarifi isteğinde başlangıç veya varış noktasını belirtirken bir sorgu dizesi (örneğin, "Chicago, IL" veya "Darwin, NSW, Avustralya"), bir LatLng değeri ya da bir Yer nesnesi belirtebilirsiniz.

Yol tarifi hizmeti, bir dizi ara nokta kullanarak çok parçalı yol tarifleri döndürebilir. Yol tarifleri, rotayı haritada çizen bir çoklu çizgi çizimi olarak veya ek olarak bir <div> öğesi içindeki bir dizi metin açıklaması olarak gösterilir (örneğin, "Williamsburg Köprüsü rampasına sağa dönün").

Başlarken

Maps JavaScript API'de Directions hizmetini kullanmadan önce, Directions API'nin (Legacy) Google Cloud Console'da Maps JavaScript API için ayarladığınız projede etkinleştirildiğinden emin olun.

Etkinleştirilen API'lerinizin listesini görüntülemek için:

  1. Google Cloud Console'a gidin.
  2. Proje seç düğmesini tıklayın, ardından Haritalar JavaScript API'si için ayarladığınız projeyi seçip Aç'ı tıklayın.
  3. Kontrol Paneli'ndeki API listesinde Directions API (Eski)'yi bulun.
  4. Listede API'yi görüyorsanız hazırsınız demektir. API listelenmemişse https://console.cloud.google.com/apis/library/directions-backend.googleapis.com adresinden etkinleştirin.

Fiyatlandırma ve politikalar

Fiyatlandırma

JavaScript Yol Tarifi Hizmeti'nin fiyatlandırma ve kullanım politikaları hakkında bilgi edinmek için Directions API (Eski) ile ilgili Kullanım ve Faturalandırma bölümüne bakın.

Politikalar

Yol Tarifi hizmetinin kullanımı, Yol Tarifi API'si (Eski) için açıklanan politikalara uygun olmalıdır.

Yol tarifi istekleri

Google Haritalar API'sinin harici bir sunucuya çağrı yapması gerektiğinden Yol Tarifi hizmetine erişim eşzamansızdır. Bu nedenle, istek tamamlandığında yürütülecek bir geri çağırma yöntemi iletmeniz gerekir. Bu geri çağırma yöntemi, sonuçları işlemelidir. Yol tarifi hizmetinin, ayrı routes[] dizisi olarak birden fazla olası seyahat planı döndürebileceğini unutmayın.

Maps JavaScript API'de yol tariflerini kullanmak için DirectionsService türünde bir nesne oluşturun ve DirectionsService.route() işlevini çağırarak Directions hizmetine bir istek başlatın. Bu işlev, giriş terimlerini içeren bir DirectionsRequest nesne değişmezini ve yanıt alındığında yürütülecek bir geri çağırma yöntemini iletir.

DirectionsRequest nesne değişmezi aşağıdaki alanları içerir:

{
  origin: LatLng | String | google.maps.Place,
  destination: LatLng | String | google.maps.Place,
  travelMode: TravelMode,
  transitOptions: TransitOptions,
  drivingOptions: DrivingOptions,
  unitSystem: UnitSystem,
  waypoints[]: DirectionsWaypoint,
  optimizeWaypoints: Boolean,
  provideRouteAlternatives: Boolean,
  avoidFerries: Boolean,
  avoidHighways: Boolean,
  avoidTolls: Boolean,
  region: String
}

Bu alanlar aşağıda açıklanmıştır:

  • origin (zorunlu), yol tariflerinin hesaplanacağı başlangıç konumunu belirtir. Bu değer String (ör. "Chicago, IL"), LatLng değeri veya Yer nesnesi olarak belirtilebilir. Yer nesnesi kullanıyorsanız yer kimliği, sorgu dizesi veya LatLng konum belirtebilirsiniz. Yer kimliklerini Maps JavaScript API'deki Geocoding, Yer Arama ve Yer Otomatik Tamamlama hizmetlerinden alabilirsiniz. Yer Adı Otomatik Tamamlama'dan alınan yer kimliklerinin kullanıldığı bir örnek için Yer Adı Otomatik Tamamlama ve Yol Tarifleri başlıklı makaleyi inceleyin.
  • destination (zorunlu), yol tarifinin hesaplanacağı bitiş konumunu belirtir. Seçenekler, yukarıda açıklanan origin alanı için kullanılan seçeneklerle aynıdır.
  • travelMode (zorunlu), yol tarifleri hesaplanırken hangi ulaşım şeklinin kullanılacağını belirtir. Geçerli değerler aşağıdaki Seyahat Modları bölümünde belirtilmiştir.
  • transitOptions (isteğe bağlı), yalnızca travelMode değerinin TRANSIT olduğu istekler için geçerli olan değerleri belirtir. Geçerli değerler aşağıdaki Toplu Taşıma Seçenekleri bölümünde açıklanmıştır.
  • drivingOptions (isteğe bağlı), yalnızca travelMode değerinin DRIVING olduğu istekler için geçerli olan değerleri belirtir. Geçerli değerler aşağıdaki Sürüş Seçenekleri bölümünde açıklanmıştır.

  • unitSystem (isteğe bağlı), sonuçları gösterirken hangi birim sisteminin kullanılacağını belirtir. Geçerli değerler, aşağıdaki Birim Sistemleri bölümünde belirtilmiştir.

  • waypoints[] (isteğe bağlı), DirectionsWaypoint dizisini belirtir. Ara noktalar, rotayı belirtilen konumlardan geçirecek şekilde değiştirir. Bir yol noktası, aşağıdaki alanlara sahip bir nesne değişmezi olarak belirtilir:

    • location, ara noktanın konumunu LatLng, Yer nesnesi veya coğrafi olarak kodlanacak String olarak belirtir.
    • stopover, ara noktanın rotada bir durak olduğunu gösteren bir boole değeridir. Bu değer, rotayı iki rotaya bölme etkisine sahiptir.

    (Ara noktalar hakkında daha fazla bilgi için aşağıdaki Rotalarda Ara Noktaları Kullanma bölümüne bakın.)

  • optimizeWaypoints (isteğe bağlı), sağlanan waypoints kullanılarak oluşturulan rotanın, ara noktaları daha verimli bir sıraya göre yeniden düzenleyerek optimize edilebileceğini belirtir. Bu durumda, Yol Tarifi Hizmeti, yeniden sıralanmış true, waypoints alanında döndürür.(Daha fazla bilgi için aşağıdaki Rotalarda Ara Noktaları Kullanma bölümüne bakın.)waypoint_order
  • provideRouteAlternatives (isteğe bağlı) true olarak ayarlandığında Yol Tarifi hizmetinin yanıtta birden fazla rota alternatifi sağlayabileceğini belirtir. Rota alternatifleri sunmanın sunucudan alınan yanıt süresini artırabileceğini unutmayın. Bu özellik yalnızca ara yol noktası içermeyen istekler için kullanılabilir.
  • avoidFerries (isteğe bağlı) true olarak ayarlandığında, hesaplanan rotaların mümkünse feribotlardan kaçınması gerektiğini belirtir.
  • avoidHighways (isteğe bağlı) true olarak ayarlandığında, hesaplanan rotaların mümkünse büyük otoyollardan kaçınması gerektiğini belirtir.
  • avoidTolls (isteğe bağlı) true olarak ayarlandığında, hesaplanan rotaların mümkünse paralı yollardan kaçınması gerektiğini belirtir.
  • region (isteğe bağlı) ccTLD ("üst düzey alan adı") olarak belirtilen bölge kodunu iki karakterlik bir değer olarak belirtir. (Daha fazla bilgi için aşağıdaki Bölge Tercihi bölümüne bakın.)

Aşağıda örnek bir DirectionsRequest verilmiştir:

{
  origin: 'Chicago, IL',
  destination: 'Los Angeles, CA',
  waypoints: [
    {
      location: 'Joplin, MO',
      stopover: false
    },{
      location: 'Oklahoma City, OK',
      stopover: true
    }],
  provideRouteAlternatives: false,
  travelMode: 'DRIVING',
  drivingOptions: {
    departureTime: new Date(/* now, or future date */),
    trafficModel: 'pessimistic'
  },
  unitSystem: google.maps.UnitSystem.IMPERIAL
}

Ulaşım şekilleri

Yol tarifini hesaplarken hangi ulaşım modunun kullanılacağını belirtmeniz gerekir. Şu anda aşağıdaki seyahat modları desteklenmektedir:

  • DRIVING (Varsayılan) Karayolu ağını kullanarak standart yol tariflerini gösterir.
  • BICYCLING, bisiklet yolları ve tercih edilen caddeler üzerinden bisikletle yol tarifi istiyor.
  • TRANSIT toplu taşıma rotaları üzerinden yol tarifi ister.
  • WALKING Yaya yolları ve kaldırımlar üzerinden yaya yol tarifi istekleri.

Bir ülkenin yol tariflerini ne ölçüde desteklediğini belirlemek için Google Haritalar Platformu Kapsam Ayrıntıları'na bakın. Bu yol tarifi türünün kullanılamadığı bir bölge için yol tarifi isteğinde bulunursanız yanıt DirectionsStatus="ZERO_RESULTS" değerini döndürür.

Not: Yaya yol tarifleri, net yaya yollarını içermeyebilir. Bu nedenle, yaya yol tarifleri DirectionsResult içinde uyarılar gösterir. Bu uyarılar her zaman kullanıcıya gösterilmelidir. Varsayılan DirectionsRenderer öğesini kullanmıyorsanız uyarıların gösterilmesini sağlamak sizin sorumluluğunuzdadır.

Toplu Taşıma Seçenekleri

Yol tarifi isteği için kullanılabilen seçenekler ulaşım şekillerine göre değişir. Toplu taşıma yol tarifi istenirken avoidHighways, avoidTolls, waypoints[] ve optimizeWaypoints seçenekleri yoksayılır. TransitOptions nesne değişmezi aracılığıyla toplu taşıma araçlarına özel rota seçenekleri belirtebilirsiniz.

Toplu taşımayla yol tarifleri zamana duyarlıdır. Yalnızca gelecekteki zamanlar için yol tarifleri döndürülür.

TransitOptions nesne değişmezi aşağıdaki alanları içerir:

{
  arrivalTime: Date,
  departureTime: Date,
  modes[]: TransitMode,
  routingPreference: TransitRoutePreference
}

Bu alanlar aşağıda açıklanmıştır:

  • arrivalTime (isteğe bağlı), istenen varış zamanını Date nesnesi olarak belirtir. Varış zamanı belirtilmişse kalkış zamanı yoksayılır.
  • departureTime (isteğe bağlı), istenen kalkış zamanını Date nesnesi olarak belirtir. arrivalTime belirtilmişse departureTime yoksayılır. departureTime veya arrivalTime için değer belirtilmezse varsayılan olarak şu anki saat kullanılır.
  • modes[] (isteğe bağlı), bir veya daha fazla TransitMode nesne değişmezi içeren bir dizidir. Bu alan yalnızca istekte bir API anahtarı varsa eklenebilir. Her TransitMode, tercih edilen bir toplu taşıma şeklini belirtir. Aşağıdaki değerlere izin verilir:
    • BUS, hesaplanan rotada otobüsle seyahatin tercih edilmesi gerektiğini gösterir.
    • RAIL, hesaplanan rotada tren, tramvay, hafif raylı sistem ve metro ile seyahatin tercih edilmesi gerektiğini gösterir.
    • SUBWAY, hesaplanan rotada metroyla seyahatin tercih edilmesi gerektiğini gösterir.
    • TRAIN, hesaplanan rotada trenle seyahatin tercih edilmesi gerektiğini gösterir.
    • TRAM, hesaplanan rotada tramvay ve hafif raylı sistemle seyahatin tercih edilmesi gerektiğini gösterir.
  • routingPreference (isteğe bağlı), toplu taşıma rotalarıyla ilgili tercihleri belirtir. Bu seçeneği kullanarak, API'nin seçtiği varsayılan en iyi rota yerine döndürülen seçenekleri tercih edebilirsiniz. Bu alan yalnızca istek bir API anahtarı içeriyorsa belirtilebilir. Aşağıdaki değerlere izin verilir:
    • FEWER_TRANSFERS hesaplanan rotada sınırlı sayıda aktarmanın tercih edilmesi gerektiğini gösterir.
    • LESS_WALKING Hesaplanan rotada sınırlı miktarda yürüyüş tercih edilmesi gerektiğini gösterir.

Toplu taşıma araçlarına göre örnek bir DirectionsRequest aşağıda gösterilmektedir:

{
  origin: 'Hoboken NJ',
  destination: 'Carroll Gardens, Brooklyn',
  travelMode: 'TRANSIT',
  transitOptions: {
    departureTime: new Date(1337675679473),
    modes: ['BUS'],
    routingPreference: 'FEWER_TRANSFERS'
  },
  unitSystem: google.maps.UnitSystem.IMPERIAL
}

Sürüş Seçenekleri

Sürüş yol tarifleri için yönlendirme seçeneklerini DrivingOptions nesnesi üzerinden belirleyebilirsiniz.

DrivingOptions nesnesi aşağıdaki alanları içerir:

{
  departureTime: Date,
  trafficModel: TrafficModel
}

Bu alanlar aşağıda açıklanmıştır:

  • departureTime (drivingOptions nesne değişmezinin geçerli olması için zorunlu), istenen kalkış zamanını Date nesnesi olarak belirtir. Değer, geçerli zamana veya gelecekteki bir zamana ayarlanmalıdır. Geçmişte olamaz. (API, farklı saat dilimlerinde tutarlı işlem yapılmasını sağlamak için tüm tarihleri UTC'ye dönüştürür.) Google Maps Platform Premium Planı müşterileri için, isteğe departureTime dahil ederseniz API, o sırada beklenen trafik koşulları göz önüne alındığında en iyi rotayı döndürür ve yanıta trafikteki tahmini süreyi (duration_in_traffic) ekler. Kalkış saati belirtmezseniz (yani istek drivingOptions içermiyorsa) döndürülen rota, trafik koşulları dikkate alınmadan genel olarak iyi bir rotadır.
  • trafficModel (isteğe bağlı) trafikteki süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, yanıttaki duration_in_traffic alanında döndürülen değeri etkiler. Bu alan, geçmiş ortalamalara göre trafikteki tahmini süreyi içerir. Varsayılan olarak bestguess değerine ayarlanır. Aşağıdaki değerlere izin verilir:
    • bestguess (varsayılan), döndürülen duration_in_traffic değerinin, hem geçmiş trafik koşulları hem de canlı trafik hakkında bilinenler göz önüne alındığında seyahat süresinin en iyi tahmini olması gerektiğini gösterir. Canlı trafik, departureTime şu ana ne kadar yakınsa o kadar önemli hale gelir.
    • pessimistic, döndürülen duration_in_traffic değerinin çoğu günde gerçek seyahat süresinden daha uzun olması gerektiğini gösterir. Ancak trafik koşullarının özellikle kötü olduğu bazı günlerde bu değer aşılabilir.
    • optimistic, döndürülen duration_in_traffic değerinin çoğu günde gerçek seyahat süresinden daha kısa olması gerektiğini gösterir. Ancak trafik koşullarının özellikle iyi olduğu bazı günlerde bu değerden daha hızlı olabilir.

Aşağıda, yol tarifleri için örnek bir DirectionsRequest verilmiştir:

{
  origin: 'Chicago, IL',
  destination: 'Los Angeles, CA',
  travelMode: 'DRIVING',
  drivingOptions: {
    departureTime: new Date(Date.now() + N),  // for the time N milliseconds from now.
    trafficModel: 'optimistic'
  }
}

Birim Sistemleri

Varsayılan olarak, yol tarifleri başlangıç noktasının bulunduğu ülkenin veya bölgenin birim sistemi kullanılarak hesaplanır ve gösterilir. (Not: Adres yerine enlem/boylam koordinatları kullanılarak ifade edilen kaynaklar her zaman varsayılan olarak metrik birimlere ayarlanır.) Örneğin, "Chicago, IL"den "Toronto, ONT"ye giden bir rotada sonuçlar mil cinsinden gösterilirken tersi yöndeki rotada sonuçlar kilometre cinsinden gösterilir. Aşağıdaki UnitSystem değerlerden birini kullanarak istekte açıkça birim sistemi belirterek bu birim sistemini geçersiz kılabilirsiniz:

  • UnitSystem.METRIC, metrik sistemin kullanımını belirtir. Mesafeler kilometre cinsinden gösterilir.
  • UnitSystem.IMPERIAL, Imperial (İngiliz) sisteminin kullanımını belirtir. Mesafeler mil cinsinden gösterilir.

Not: Bu birim sistemi ayarı yalnızca kullanıcıya gösterilen metni etkiler. Yol tarifi sonucu, kullanıcılara gösterilmeyen ve her zaman metre cinsinden ifade edilen mesafe değerlerini de içerir.

Yol tarifleri için bölge tercihi

Google Haritalar API Directions Service, JavaScript bootstrap'i yüklediğiniz alan adından (bölge veya ülke) etkilenen adres sonuçları döndürür. (Çoğu kullanıcı https://maps.googleapis.com/ yüklediğinden https://maps.googleapis.com/ bu, ABD için örtülü bir alan ayarlar.) Bootstrap'i farklı bir desteklenen alandan yüklerseniz bu alandan etkilenen sonuçlar elde edersiniz. Örneğin, "San Francisco" aramaları, https://maps.googleapis.com/ (ABD) yükleyen uygulamalardan farklı sonuçlar döndürebilir.http://maps.google.es/

region parametresini kullanarak Yol Tarifi hizmetini belirli bir bölgeye yönelik sonuçlar döndürecek şekilde de ayarlayabilirsiniz. Bu parametre, iki karakterli (sayısal olmayan) Unicode bölge alt etiketi olarak belirtilen bir bölge kodu alır. Çoğu durumda bu etiketler, doğrudan ccTLD ("üst düzey alan") iki karakterli değerlerle eşlenir. Örneğin, "co.uk" için "uk". Bazı durumlarda region etiketi, ccTLD değerlerinden farklı olabilen ISO-3166-1 kodlarını da destekler (örneğin, "Büyük Britanya" için "GB").

region parametresini kullanırken:

  • Yalnızca bir ülke veya bölge belirtin. Birden fazla değer yok sayılır ve bu durum isteğin başarısız olmasına neden olabilir.
  • Yalnızca iki karakterli bölge alt etiketlerini (Unicode CLDR biçimi) kullanın. Diğer tüm girişler hataya neden olur.

Bölgeye göre önyargı yalnızca yol tariflerini destekleyen ülkeler ve bölgeler için desteklenir. Yol Tarifi API'sinin (Eski) uluslararası kapsamını görmek için Google Haritalar Platformu Kapsam Ayrıntıları'na bakın.

Oluşturma Yönergeleri

DirectionsService ile route() yöntemi kullanılarak yol tarifi isteği başlatmak için hizmet isteği tamamlandığında yürütülen bir geri çağırma işlevinin iletilmesi gerekir. Bu geri çağırma, yanıtta DirectionsResult ve DirectionsStatus kodunu döndürür.

Yol Tarifi Sorgusunun Durumu

DirectionsStatus aşağıdaki değerleri döndürebilir:

  • OK, yanıtın DirectionsResult içerdiğini gösterir.
  • NOT_FOUND, isteğin başlangıç, hedef veya ara noktalarında belirtilen konumlardan en az birine coğrafi kodlama uygulanamadığını gösterir.
  • ZERO_RESULTS, başlangıç ve varış noktası arasında rota bulunamadığını gösterir.
  • MAX_WAYPOINTS_EXCEEDED, DirectionsRequest içinde çok fazla DirectionsWaypoint alanı sağlandığını gösterir. Ara noktalarla ilgili sınırlar hakkında bilgi edinmek için aşağıdaki bölüme bakın.
  • MAX_ROUTE_LENGTH_EXCEEDED, istenen rotanın çok uzun olduğunu ve işlenemediğini gösterir. Bu hata, daha karmaşık talimatlar döndürüldüğünde oluşur. Ara nokta, dönüş veya talimat sayısını azaltmayı deneyin.
  • INVALID_REQUEST, sağlanan DirectionsRequest öğesinin geçersiz olduğunu gösterir. Bu hata kodunun en yaygın nedenleri, kaynak veya hedef bilgisi eksik olan istekler ya da ara noktalar içeren bir aktarım isteğidir.
  • OVER_QUERY_LIMIT, web sayfasının izin verilen süre içinde çok fazla istek gönderdiğini gösterir.
  • REQUEST_DENIED, web sayfasının yol tarifi hizmetini kullanmasına izin verilmediğini gösterir.
  • UNKNOWN_ERROR, bir yol tarifi isteğinin sunucu hatası nedeniyle işlenemediğini gösterir. Tekrar denerseniz istek başarılı olabilir.

Sonucu işlemeden önce bu değeri kontrol ederek yol tarifi sorgusunun geçerli sonuçlar döndürdüğünden emin olmanız gerekir.

DirectionsResult'u görüntüleme

DirectionsResult, yol tarifi sorgusunun sonucunu içerir. Bu sonucu kendiniz işleyebilir veya sonucu haritada otomatik olarak gösterebilen bir DirectionsRenderer nesnesine iletebilirsiniz.

DirectionsResult içeriğini DirectionsRenderer kullanarak göstermek için aşağıdakileri yapmanız gerekir:

  1. DirectionsRenderer nesnesi oluşturun.
  2. Oluşturucuda setMap() işlevini çağırarak bunu iletilen haritaya bağlayın.
  3. Oluşturucuda setDirections() işlevini çağırın ve yukarıda belirtildiği gibi DirectionsResult değerini iletin. Oluşturucu bir MVCObject olduğundan, özelliklerinde yapılan değişiklikleri otomatik olarak algılar ve ilişkili yol tarifleri değiştiğinde haritayı günceller.

Aşağıdaki örnekte, 66 numaralı yol üzerindeki iki konum arasındaki yol tarifleri hesaplanmaktadır. Başlangıç ve hedef, açılır listelerdeki "start" ve "end" değerleriyle belirlenir. DirectionsRenderer işaretleri, belirtilen konumlar arasındaki çoklu çizginin gösterilmesini ve başlangıç, varış noktası ile varsa ara noktalara işaretçi yerleştirilmesini sağlar.

function initMap() {
  var directionsService = new google.maps.DirectionsService();
  var directionsRenderer = new google.maps.DirectionsRenderer();
  var chicago = new google.maps.LatLng(41.850033, -87.6500523);
  var mapOptions = {
    zoom:7,
    center: chicago
  }
  var map = new google.maps.Map(document.getElementById('map'), mapOptions);
  directionsRenderer.setMap(map);
}

function calcRoute() {
  var start = document.getElementById('start').value;
  var end = document.getElementById('end').value;
  var request = {
    origin: start,
    destination: end,
    travelMode: 'DRIVING'
  };
  directionsService.route(request, function(result, status) {
    if (status == 'OK') {
      directionsRenderer.setDirections(result);
    }
  });
}

HTML gövdesinde:

<div>
<strong>Start: </strong>
<select id="start" onchange="calcRoute();">
  <option value="chicago, il">Chicago</option>
  <option value="st louis, mo">St Louis</option>
  <option value="joplin, mo">Joplin, MO</option>
  <option value="oklahoma city, ok">Oklahoma City</option>
  <option value="amarillo, tx">Amarillo</option>
  <option value="gallup, nm">Gallup, NM</option>
  <option value="flagstaff, az">Flagstaff, AZ</option>
  <option value="winona, az">Winona</option>
  <option value="kingman, az">Kingman</option>
  <option value="barstow, ca">Barstow</option>
  <option value="san bernardino, ca">San Bernardino</option>
  <option value="los angeles, ca">Los Angeles</option>
</select>
<strong>End: </strong>
<select id="end" onchange="calcRoute();">
  <option value="chicago, il">Chicago</option>
  <option value="st louis, mo">St Louis</option>
  <option value="joplin, mo">Joplin, MO</option>
  <option value="oklahoma city, ok">Oklahoma City</option>
  <option value="amarillo, tx">Amarillo</option>
  <option value="gallup, nm">Gallup, NM</option>
  <option value="flagstaff, az">Flagstaff, AZ</option>
  <option value="winona, az">Winona</option>
  <option value="kingman, az">Kingman</option>
  <option value="barstow, ca">Barstow</option>
  <option value="san bernardino, ca">San Bernardino</option>
  <option value="los angeles, ca">Los Angeles</option>
</select>
</div>

Örneği görüntüleyin

Aşağıdaki örnekte, Kaliforniya, San Francisco'daki Haight-Ashbury ile Ocean Beach arasında farklı ulaşım modları kullanılarak yol tarifleri gösterilmektedir:

function initMap() {
  var directionsService = new google.maps.DirectionsService();
  var directionsRenderer = new google.maps.DirectionsRenderer();
  var haight = new google.maps.LatLng(37.7699298, -122.4469157);
  var oceanBeach = new google.maps.LatLng(37.7683909618184, -122.51089453697205);
  var mapOptions = {
    zoom: 14,
    center: haight
  }
  var map = new google.maps.Map(document.getElementById('map'), mapOptions);
  directionsRenderer.setMap(map);
}

function calcRoute() {
  var selectedMode = document.getElementById('mode').value;
  var request = {
      origin: haight,
      destination: oceanBeach,
      // Note that JavaScript allows us to access the constant
      // using square brackets and a string value as its
      // "property."
      travelMode: google.maps.TravelMode[selectedMode]
  };
  directionsService.route(request, function(response, status) {
    if (status == 'OK') {
      directionsRenderer.setDirections(response);
    }
  });
}

HTML gövdesinde:

<div>
<strong>Mode of Travel: </strong>
<select id="mode" onchange="calcRoute();">
  <option value="DRIVING">Driving</option>
  <option value="WALKING">Walking</option>
  <option value="BICYCLING">Bicycling</option>
  <option value="TRANSIT">Transit</option>
</select>
</div>

Örneği görüntüleyin

Bir DirectionsRenderer yalnızca çoklu çizginin ve ilişkili işaretçilerin gösterilmesini sağlamakla kalmaz, aynı zamanda yol tariflerinin metin olarak adım adım gösterilmesini de sağlayabilir. Bunu yapmak için setPanel() işlevini DirectionsRenderer cihazınızda çağırın ve bu bilgilerin gösterileceği <div> öğesini iletin. Bu sayede, uygun telif hakkı bilgilerini ve sonuçla ilişkili olabilecek uyarıları da gösterirsiniz.

Metin talimatları, tarayıcının tercih edilen dil ayarı veya language parametresi kullanılarak API JavaScript'i yüklenirken belirtilen dil kullanılarak sağlanır. (Daha fazla bilgi için Yerelleştirme bölümünü inceleyin.) Toplu taşıma yol tariflerinde saat, söz konusu toplu taşıma durağının saat diliminde gösterilir.

Aşağıdaki örnek, yukarıda gösterilenle aynıdır ancak yol tariflerini göstermek için <div> panelini içerir:

function initMap() {
  var directionsService = new google.maps.DirectionsService();
  var directionsRenderer = new google.maps.DirectionsRenderer();
  var chicago = new google.maps.LatLng(41.850033, -87.6500523);
  var mapOptions = {
    zoom:7,
    center: chicago
  }
  var map = new google.maps.Map(document.getElementById('map'), mapOptions);
  directionsRenderer.setMap(map);
  directionsRenderer.setPanel(document.getElementById('directionsPanel'));
}

function calcRoute() {
  var start = document.getElementById('start').value;
  var end = document.getElementById('end').value;
  var request = {
    origin:start,
    destination:end,
    travelMode: 'DRIVING'
  };
  directionsService.route(request, function(response, status) {
    if (status == 'OK') {
      directionsRenderer.setDirections(response);
    }
  });
}

HTML gövdesinde:

<div id="map" style="float:left;width:70%;height:100%"></div>
<div id="directionsPanel" style="float:right;width:30%;height:100%"></div>

Örneği görüntüleyin

DirectionsResult nesnesi

DirectionsService adresine bir rota isteği gönderdiğinizde, durum kodu ve sonuçtan oluşan bir yanıt alırsınız. Sonuç, DirectionsResult nesnesidir. DirectionsResult, aşağıdaki alanları içeren bir nesne değişmezidir:

  • geocoded_waypoints[], her biri başlangıç noktası, varış noktası ve ara noktaların coğrafi kodlamasıyla ilgili ayrıntıları içeren bir DirectionsGeocodedWaypoint nesneleri dizisi içerir.
  • routes[], DirectionsRoute nesnelerinden oluşan bir dizi içerir. Her rota, DirectionsRequest içinde belirtilen başlangıç noktasından varış noktasına gitmenin bir yolunu gösterir. Genellikle, isteğin provideRouteAlternatives alanı true olarak ayarlanmadığı sürece herhangi bir istek için yalnızca bir rota döndürülür. Bu durumda birden fazla rota döndürülebilir.

Not: via_waypoint özelliği, alternatif rotalarda kullanımdan kaldırılmıştır. 3.27 sürümü, alternatif rotalara ek ara noktalar ekleyen son API sürümüdür. API'nin 3.28 ve sonraki sürümlerinde, alternatif rotaların sürüklenmesini devre dışı bırakarak Directions hizmetini kullanarak sürüklenebilir yol tarifleri uygulamaya devam edebilirsiniz. Yalnızca ana rota sürüklenebilir olmalıdır. Kullanıcılar, ana rotayı alternatif bir rotayla eşleşene kadar sürükleyebilir.

Yol Tarifi Coğrafi Kodlu Ara Noktalar

DirectionsGeocodedWaypoint, başlangıç noktası, varış noktası ve ara noktaların coğrafi kodlamasıyla ilgili ayrıntıları içerir.

DirectionsGeocodedWaypoint, aşağıdaki alanları içeren bir nesne değişmezidir:

  • geocoder_status, coğrafi kodlama işleminden kaynaklanan durum kodunu gösterir. Bu alan aşağıdaki değerleri içerebilir.
    • "OK", hata oluşmadığını, adresin başarıyla ayrıştırıldığını ve en az bir coğrafi kodun döndürüldüğünü gösterir.
    • "ZERO_RESULTS", coğrafi kodlamanın başarılı olduğunu ancak sonuç döndürmediğini gösterir. Bu durum, coğrafi kodlayıcıya mevcut olmayan bir address iletilirse ortaya çıkabilir.

  • partial_match, kodlayıcının, istenen adresin bir kısmını eşleştirebilmesine rağmen orijinal istek için tam bir eşleşme döndürmediğini gösterir. Yazım hataları ve/veya eksik adres olup olmadığını kontrol etmek için orijinal isteği inceleyebilirsiniz.

    Kısmi eşleşmeler en sık, istekte ilettiğiniz yerleşim biriminde bulunmayan sokak adresleri için gerçekleşir. Aynı yerleşim yerindeki iki veya daha fazla konumla eşleşen bir istek olduğunda da kısmi eşleşmeler döndürülebilir. Örneğin, "Hillpar St, Bristol, UK" hem Henry Street hem de Henrietta Street için kısmi eşleşme döndürür. Bir istekte yanlış yazılmış bir adres bileşeni varsa coğrafi kodlama hizmetinin alternatif bir adres önerebileceğini unutmayın. Bu şekilde tetiklenen öneriler de kısmi eşleşme olarak işaretlenir.

  • place_id, bir yerin benzersiz tanımlayıcısıdır ve diğer Google API'leriyle birlikte kullanılabilir. Örneğin, yerel bir işletmenin telefon numarası, çalışma saatleri ve kullanıcı yorumları gibi ayrıntılarını almak için place_id kitaplığını Google Places API ile birlikte kullanabilirsiniz. Yer kimliğine genel bakış başlıklı makaleyi inceleyin.
  • types[], döndürülen sonucun türünü belirten bir dizidir. Bu dizi, sonuçta döndürülen özellik türünü tanımlayan sıfır veya daha fazla etiket kümesi içerir. Örneğin, "Chicago"nun coğrafi kodu, "Chicago"nun bir şehir olduğunu belirten "locality" ve siyasi bir varlık olduğunu belirten "political" değerini döndürür.

Yol Tarifi Rotaları

Not: Eski DirectionsTrip nesnesinin adı DirectionsRoute olarak değiştirildi. Bir rotanın artık yalnızca üst gezinin bir ayağını değil, başlangıçtan bitişe kadar olan tüm yolculuğu ifade ettiğini unutmayın.

DirectionsRoute, belirtilen kaynak ve hedeften tek bir sonuç içerir. Bu rota, herhangi bir ara nokta belirtilip belirtilmediğine bağlı olarak bir veya daha fazla ayaktan (DirectionsLeg türünde) oluşabilir. Ayrıca, rotada telif hakkı ve uyarı bilgileri de yer alır. Bu bilgiler, rota bilgilerine ek olarak kullanıcıya gösterilmelidir.

DirectionsRoute, aşağıdaki alanları içeren bir nesne değişmezidir:

  • legs[], DirectionsLeg nesnelerinden oluşan bir dizi içerir. Bu nesnelerin her biri, belirli bir rotadaki iki konumdan rotanın bir ayağıyla ilgili bilgileri içerir. Belirtilen her ara nokta veya hedef için ayrı bir etap bulunur. (Ara nokta içermeyen bir rotada tam olarak bir DirectionsLeg bulunur.) Her etap, bir dizi DirectionStep'den oluşur.
  • waypoint_order, hesaplanan rotadaki tüm ara noktaların sırasını gösteren bir dizi içerir. Bu dizi, DirectionsRequest iletilirse değiştirilmiş bir sıra içerebilir. optimizeWaypoints: true.
  • overview_path, sonuçtaki yol tariflerinin yaklaşık (düzeltilmiş) yolunu gösteren bir LatLng dizisi içerir.
  • overview_polyline, rotanın kodlanmış çoklu çizgi gösterimini içeren tek bir points nesnesi içerir. Bu çoklu çizgi, sonuçta elde edilen yol tariflerinin yaklaşık (düzeltilmiş) yoludur.
  • bounds, bu rota boyunca çoklu çizginin sınırlarını gösteren bir LatLngBounds içerir.
  • copyrights, bu rota için gösterilecek telif hakkı metnini içerir.
  • warnings[], bu yol tarifleri gösterilirken görüntülenecek bir uyarı dizisi içerir. Sağlanan DirectionsRenderer nesnesini kullanmıyorsanız bu uyarıları kendiniz yönetip göstermeniz gerekir.
  • fare, bu rotadaki toplam ücreti (yani toplam bilet maliyetlerini) içerir. Bu özellik yalnızca toplu taşıma istekleri için ve yalnızca tüm toplu taşıma ayakları için ücret bilgisi bulunan rotalarda döndürülür. Bu bilgiler arasında şunlar yer alır:
    • currency: Tutarın ifade edildiği para birimini gösteren ISO 4217 para birimi kodu.
    • value: Yukarıda belirtilen para biriminde toplam ücret tutarı.

Directions Legs

Not: Eski DirectionsRoute nesnesinin adı DirectionsLeg olarak değiştirildi.

DirectionsLeg, hesaplanan rotada başlangıç noktasından varış noktasına giden bir yolculuğun tek bir ayağını tanımlar. Hiç ara nokta içermeyen rotalar tek bir "etaptan" oluşur. Bir veya daha fazla ara nokta tanımlayan rotalar ise yolculuğun belirli etaplarına karşılık gelen bir veya daha fazla etaptan oluşur.

DirectionsLeg, aşağıdaki alanlara sahip bir nesne değişmezidir:

  • steps[], yolculuğun her bir ayağının ayrı adımlarıyla ilgili bilgileri gösteren bir DirectionsStep nesne dizisi içerir.

  • distance, bu ayağın kat ettiği toplam mesafeyi aşağıdaki biçimde bir Distance nesnesi olarak gösterir:

    • value, mesafeyi metre cinsinden gösterir.
    • text, mesafenin dize gösterimini içerir. Bu mesafe, varsayılan olarak başlangıç noktasında kullanılan birimlerle gösterilir. (Örneğin, ABD'deki herhangi bir başlangıç noktası için mil kullanılır.) Orijinal sorguda özellikle bir UnitSystem ayarlayarak bu birim sistemini geçersiz kılabilirsiniz. Hangi birim sistemini kullandığınızdan bağımsız olarak distance.value alanının her zaman metre cinsinden bir değer içerdiğini unutmayın.

    Mesafe bilinmiyorsa bu alanlar tanımlanmamış olabilir.

  • duration, bu ayağın toplam süresini aşağıdaki biçimde bir Duration nesnesi olarak gösterir:

    • value, süreyi saniye cinsinden gösterir.
    • text, sürenin dize gösterimini içerir.

    Süre bilinmiyorsa bu alanlar tanımlanmamış olabilir.

  • duration_in_traffic, mevcut trafik koşulları dikkate alınarak bu ayağın toplam süresini gösterir. duration_in_traffic yalnızca aşağıdakilerin tümü doğruysa döndürülür:

    • İstek, aktarma noktaları içermiyor. Yani stopover değerinin true olduğu ara noktaları içermez.
    • İstek özellikle yol tarifi içindir. mode, driving olarak ayarlanmıştır.
    • departureTime, istekteki drivingOptions alanının bir parçası olarak eklenir.
    • İstenen rota için trafik koşulları bilgisi mevcuttur.

    duration_in_traffic aşağıdaki alanları içerir:

    • value, süreyi saniye cinsinden gösterir.
    • text, sürenin kullanıcılar tarafından okunabilir bir gösterimini içerir.
  • arrival_time, bu etap için tahmini varış zamanını içerir. Bu özellik yalnızca toplu taşıma yol tarifleri için döndürülür. Sonuç, üç özelliği olan bir Time nesnesi olarak döndürülür:
    • value JavaScript nesnesi olarak belirtilen saat.Date
    • text dize olarak belirtilen saat. Saat, toplu taşıma durağının saat diliminde gösterilir.
    • time_zone, bu istasyonun saat dilimini içerir. Değer, IANA Saat Dilimi Veritabanı'nda tanımlanan saat diliminin adıdır (ör. "America/New_York").
  • departure_time, bu ayağın tahmini kalkış zamanını Time nesnesi olarak belirtilmiş şekilde içerir. departure_time yalnızca toplu taşıma yol tarifleri için kullanılabilir.
  • start_location, bu ayağın kaynağının LatLng değerini içerir. Directions Web Hizmeti, konumlar arasındaki rotaları başlangıç ve bitiş noktalarındaki en yakın ulaşım seçeneğini (genellikle bir yol) kullanarak hesapladığından, start_location, örneğin başlangıç noktasının yakınında bir yol yoksa bu ayağın sağlanan başlangıç noktasından farklı olabilir.
  • end_location, bu ayağın hedefinin LatLng değerini içerir. DirectionsService, başlangıç ve bitiş noktalarındaki en yakın ulaşım seçeneğini (genellikle bir yol) kullanarak konumlar arasındaki rotaları hesapladığı için end_location, örneğin varış noktasının yakınında bir yol yoksa bu ayağın sağlanan varış noktasından farklı olabilir.
  • start_address Bu ayağın başlangıcının kullanıcı tarafından okunabilir adresini (genellikle açık adres) içerir.

    Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adres programatik olarak ayrıştırılmamalıdır.
  • end_address, bu ayağın sonundaki kullanıcı tarafından okunabilir adresi (genellikle açık adres) içerir.

    Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adres programatik olarak ayrıştırılmamalıdır.

Yol Tarifi Adımları

DirectionsStep, bir yol tarifinin en küçük birimidir ve yolculukla ilgili belirli bir talimatı açıklayan tek bir adımı içerir. Örneğin, "W. 4th St." Adımda yalnızca talimat açıklanmaz, aynı zamanda bu adımın bir sonraki adımla ilişkisine dair mesafe ve süre bilgileri de yer alır. Örneğin, "I-80 Batı'ya katılın" olarak belirtilen bir adım, "37 mil" ve "40 dakika" süresini içerebilir. Bu, bir sonraki adımın bu adımdan 37 mil/40 dakika uzaklıkta olduğunu gösterir.

Toplu taşıma yol tariflerini aramak için Yol Tarifi hizmeti kullanılırken steps dizisi, transit nesnesi biçiminde ek toplu taşıma bilgilerini içerir. Yol tarifinde birden fazla ulaşım şekli varsa yürüme veya araba kullanma adımları için ayrıntılı yol tarifi steps[] dizisinde sağlanır. Örneğin, yürüme adımında başlangıç ve bitiş konumlarıyla ilgili yol tarifleri yer alır: "Innes Ave & Fitch St'e doğru yürüyün". Bu adımda, steps[] dizisindeki rota için ayrıntılı yaya yol tarifleri yer alır. Örneğin: "Kuzeybatıya doğru ilerleyin", "Arelious Walker'a sola dönün" ve "Innes Ave'ye sola dönün".

DirectionsStep, aşağıdaki alanlara sahip bir nesne değişmezidir:

  • instructions, bir metin dizesi içinde bu adımla ilgili talimatlar içeriyor.
  • distance, bu adımda bir sonraki adıma kadar kat edilen mesafeyi Distance nesnesi olarak içerir. (Yukarıdaki DirectionsLeg bölümündeki açıklamaya bakın.) Mesafe bilinmiyorsa bu alan tanımlanmamış olabilir.
  • duration, bir sonraki adıma kadar olan sürede adımı gerçekleştirmek için gereken zamanın tahminini Duration nesnesi olarak içerir. (DirectionsLeg bölümündeki açıklamaya bakın.) Süre bilinmiyorsa bu alan tanımlanmamış olabilir.
  • start_location, bu adımın başlangıç noktasının coğrafi kodunu içerir. LatLng
  • end_location, bu adımın bitiş noktasının LatLng değerini içerir.
  • polyline, adımın kodlanmış çoklu çizgi gösterimini içeren tek bir points nesnesi içerir. Bu çoklu çizgi, adımın yaklaşık (düzeltilmiş) yoludur.
  • Toplu taşıma yol tariflerindeki yürüme veya araç kullanma adımlarıyla ilgili ayrıntılı yol tarifleri içeren steps[] bir DirectionsStep nesne değişmezi. Alt adımlar yalnızca toplu taşıma yol tariflerinde kullanılabilir.
  • travel_mode, bu adımda kullanılan TravelMode'yi içerir. Toplu taşıma yol tarifleri, yaya ve toplu taşıma yol tariflerinin bir kombinasyonunu içerebilir.
  • path, bu adımın sürecini açıklayan bir LatLngs dizisi içerir.
  • transit, varış ve kalkış zamanları ile toplu taşıma hattının adı gibi toplu taşıma araçlarına özel bilgileri içerir.

Toplu Taşıma Araçlarına Özgü Bilgiler

Toplu taşıma yol tarifleri, diğer ulaşım türleriyle alakalı olmayan ek bilgiler döndürür. Bu ek özellikler, TransitDetails nesnesi aracılığıyla kullanıma sunulur ve DirectionsStep nesnesinin özelliği olarak döndürülür. TransitDetails nesnesinden, TransitStop, TransitLine, TransitAgency ve VehicleType nesneleriyle ilgili ek bilgilere aşağıda açıklandığı şekilde erişebilirsiniz.

Toplu Taşıma Ayrıntıları

TransitDetails nesnesi aşağıdaki özellikleri sunar:

  • arrival_stop, aşağıdaki özelliklere sahip varış istasyonunu/durağını temsil eden bir TransitStop nesnesi içerir:
    • name Toplu taşıma istasyonunun/durağının adı. ör. "Union Square"
    • location toplu taşıma istasyonunun/durağının konumu, LatLng olarak gösterilir.
  • departure_stop, kalkış istasyonunu/durağını temsil eden bir TransitStop nesnesi içerir.
  • arrival_time, üç özelliği olan bir Time nesnesi olarak belirtilen varış zamanını içerir:
    • value JavaScript nesnesi olarak belirtilen saat.Date
    • text dize olarak belirtilen saat. Saat, toplu taşıma durağının saat diliminde gösterilir.
    • time_zone, bu istasyonun saat dilimini içerir. Değer, IANA Saat Dilimi Veritabanı'nda tanımlanan saat diliminin adıdır (ör. "America/New_York").
  • departure_time, Time nesnesi olarak belirtilen kalkış zamanını içerir.
  • headsign, araçta veya kalkış durağında işaretlendiği gibi bu hat üzerinde seyahat edilecek yönü belirtir. Bu istasyon genellikle son durak olur.
  • headway Bu değer, aynı duraktan bu saatte yapılan kalkışlar arasındaki beklenen saniye sayısını belirtir. Örneğin, headway değeri 600 ise otobüsünüzü kaçırmanız durumunda on dakika beklemeniz gerekir.
  • line, bu adımda kullanılan toplu taşıma hattıyla ilgili bilgileri içeren bir TransitLine nesne değişmezi içerir. TransitLine, hattın adını ve operatörünü, TransitLine referans dokümanında açıklanan diğer özelliklerle birlikte sağlar.
  • num_stops, bu adımdaki durak sayısını içerir. Varış durağı dahildir ancak kalkış durağı dahil değildir. Örneğin, yol tarifiniz A durağından ayrılmayı, B ve C duraklarından geçmeyi ve D durağına varmayı içeriyorsa num_stops 3 değerini döndürür.

Toplu Taşıma Hattı

TransitLine nesnesi aşağıdaki özellikleri sunar:

  • name, bu toplu taşıma hattının tam adını içerir. Örneğin: "7 Avenue Express" veya "14th St Crosstown".
  • short_name, bu toplu taşıma hattının kısa adını içerir. Bu genellikle "2" veya "M14" gibi bir satır numarası olur.
  • agencies, tek bir TransitAgency nesnesi içeren bir dizidir. TransitAgency nesnesi, aşağıdaki özellikler de dahil olmak üzere bu hattın operatörü hakkında bilgi sağlar:
    • name Transit operatörünün adını içerir.
    • phone, toplu taşıma kuruluşunun telefon numarasını içerir.
    • url, toplu taşıma kuruluşunun URL'sini içerir.

    Not: DirectionsRenderer nesnesini kullanmak yerine toplu taşıma yol tariflerini manuel olarak oluşturuyorsanız yolculuk sonuçlarına hizmet veren toplu taşıma kuruluşlarının adlarını ve URL'lerini göstermeniz gerekir.

  • url, toplu taşıma kuruluşu tarafından sağlanan bu toplu taşıma hattının URL'sini içerir.
  • icon, bu satırla ilişkili simgenin URL'sini içerir. Çoğu şehirde, araç türüne göre değişen genel simgeler kullanılır. New York metro sistemi gibi bazı toplu taşıma hatlarının, o hatta özel simgeleri vardır.
  • color Bu toplu taşıma aracının tabelalarında yaygın olarak kullanılan rengi içerir. Renk, #FF0033 gibi bir onaltılık dize olarak belirtilir.
  • text_color, bu hattın tabelalarında yaygın olarak kullanılan metin rengini içerir. Renk, onaltılık dize olarak belirtilir.
  • vehicle, aşağıdaki özellikleri içeren bir Vehicle nesnesi içerir:
    • name bu satırdaki aracın adını içerir. ör. "Subway." (Metro.)
    • type, bu hatta kullanılan araç türünü içerir. Desteklenen değerlerin tam listesi için Araç Türü dokümanına bakın.
    • icon, genellikle bu araç türüyle ilişkilendirilen simgenin URL'sini içerir.
    • local_icon, yerel ulaşım işaretlerine göre bu araç türüyle ilişkili simgenin URL'sini içerir.

Araç Türü

VehicleType nesnesi aşağıdaki özellikleri sunar:

Değer Tanım
VehicleType.RAIL Demiryolu
VehicleType.METRO_RAIL Hafif raylı sistem.
VehicleType.SUBWAY Yeraltı hafif raylı sistemi.
VehicleType.TRAM Yer üstü hafif raylı sistem.
VehicleType.MONORAIL Monoray.
VehicleType.HEAVY_RAIL Ağır raylı sistem.
VehicleType.COMMUTER_TRAIN Banliyö treni.
VehicleType.HIGH_SPEED_TRAIN Hızlı tren.
VehicleType.BUS Otobüs
VehicleType.INTERCITY_BUS Şehirlerarası otobüs
VehicleType.TROLLEYBUS Troleybüs.
VehicleType.SHARE_TAXI Paylaşımlı taksi, rotası üzerindeki herhangi bir yerde yolcu bırakma ve alma özelliğine sahip bir otobüs türüdür.
VehicleType.FERRY Feribot
VehicleType.CABLE_CAR Genellikle yerde, kablo üzerinde çalışan bir araç. Teleferikler VehicleType.GONDOLA_LIFT türünde olabilir.
VehicleType.GONDOLA_LIFT Teleferik
VehicleType.FUNICULAR Bir kabloyla dik bir yokuşta çekilen araç. Füniküler genellikle iki vagondan oluşur. Her vagon, diğer vagon için karşı ağırlık görevi görür.
VehicleType.OTHER Diğer tüm araçlar bu türü döndürür.

DirectionsResults öğesini inceleme

DirectionsResults bileşenleri (DirectionsRoute, DirectionsLeg, DirectionsStep ve TransitDetails) herhangi bir yol tarifi yanıtı ayrıştırılırken incelenebilir ve kullanılabilir.

Önemli: DirectionsRenderer nesnesini kullanmak yerine toplu taşıma yol tariflerini manuel olarak oluşturuyorsanız yolculuk sonuçlarına hizmet veren toplu taşıma kuruluşlarının adlarını ve URL'lerini göstermeniz gerekir.

Aşağıdaki örnekte, New York City'deki belirli turistik yerlere yürüme yol tarifleri çiziliyor. Rotanın DirectionsStep bölümünü inceleyerek her adım için işaretçi ekleriz ve InfoWindow bölümüne, ilgili adımın talimat metnini içeren bilgileri ekleriz.

Not: Yürüyüş rotası hesapladığımız için kullanıcıya yönelik uyarıları ayrı bir <div> panelde de gösteririz.

var map;
var directionsRenderer;
var directionsService;
var stepDisplay;
var markerArray = [];

function initMap() {
  // Instantiate a directions service.
  directionsService = new google.maps.DirectionsService();

  // Create a map and center it on Manhattan.
  var manhattan = new google.maps.LatLng(40.7711329, -73.9741874);
  var mapOptions = {
    zoom: 13,
    center: manhattan
  }
  map = new google.maps.Map(document.getElementById('map'), mapOptions);

  // Create a renderer for directions and bind it to the map.
  var rendererOptions = {
    map: map
  }
  directionsRenderer = new google.maps.DirectionsRenderer(rendererOptions)

  // Instantiate an info window to hold step text.
  stepDisplay = new google.maps.InfoWindow();
}

function calcRoute() {

  // First, clear out any existing markerArray
  // from previous calculations.
  for (i = 0; i < markerArray.length; i++) {
    markerArray[i].setMap(null);
  }

  // Retrieve the start and end locations and create
  // a DirectionsRequest using WALKING directions.
  var start = document.getElementById('start').value;
  var end = document.getElementById('end').value;
  var request = {
      origin: start,
      destination: end,
      travelMode: 'WALKING'
  };

  // Route the directions and pass the response to a
  // function to create markers for each step.
  directionsService.route(request, function(response, status) {
    if (status == "OK") {
      var warnings = document.getElementById("warnings_panel");
      warnings.innerHTML = "" + response.routes[0].warnings + "";
      directionsRenderer.setDirections(response);
      showSteps(response);
    }
  });
}

function showSteps(directionResult) {
  // For each step, place a marker, and add the text to the marker's
  // info window. Also attach the marker to an array so we
  // can keep track of it and remove it when calculating new
  // routes.
  var myRoute = directionResult.routes[0].legs[0];

  for (var i = 0; i < myRoute.steps.length; i++) {
      var marker = new google.maps.Marker({
        position: myRoute.steps[i].start_point,
        map: map
      });
      attachInstructionText(marker, myRoute.steps[i].instructions);
      markerArray[i] = marker;
  }
}

function attachInstructionText(marker, text) {
  google.maps.event.addListener(marker, 'click', function() {
    stepDisplay.setContent(text);
    stepDisplay.open(map, marker);
  });
}

HTML gövdesinde:

<div>
<strong>Start: </strong>
<select id="start">
  <option value="penn station, new york, ny">Penn Station</option>
  <option value="grand central station, new york, ny">Grand Central Station</option>
  <option value="625 8th Avenue New York NY 10018">Port Authority Bus Terminal</option>
  <option value="staten island ferry terminal, new york, ny">Staten Island Ferry Terminal</option>
  <option value="101 E 125th Street, New York, NY">Harlem - 125th St Station</option>
</select>
<strong>End: </strong>
<select id="end" onchange="calcRoute();">
  <option value="260 Broadway New York NY 10007">City Hall</option>
  <option value="W 49th St & 5th Ave, New York, NY 10020">Rockefeller Center</option>
  <option value="moma, New York, NY">MOMA</option>
  <option value="350 5th Ave, New York, NY, 10118">Empire State Building</option>
  <option value="253 West 125th Street, New York, NY">Apollo Theatre</option>
  <option value="1 Wall St, New York, NY">Wall St</option>
</select>
<div>

Örneği görüntüleyin

Rotalarda Yol Noktalarını Kullanma

DirectionsRequest içinde belirtildiği gibi, yaya, bisiklet veya araba yol tarifleri için Directions hizmetini kullanarak rotaları hesaplarken ara noktalar (DirectionsWaypoint türünde) da belirtebilirsiniz. Ara noktalar, toplu taşıma yol tariflerinde kullanılamaz. Ara noktalar, ek konumlardan geçen rotaları hesaplamanıza olanak tanır. Bu durumda, döndürülen rota belirtilen ara noktalardan geçer.

waypoint aşağıdaki alanlardan oluşur:

  • location (zorunlu), ara noktanın adresini belirtir.
  • stopover (isteğe bağlı), bu ara noktanın rotada gerçek bir durak (true) mı yoksa yalnızca belirtilen konumdan geçme tercihi (false) mi olduğunu gösterir. Duraklar varsayılan olarak true'dır.

Varsayılan olarak, Rota Talimatları hizmeti, sağlanan ara noktalar üzerinden belirli bir sırayla rota hesaplar. İsteğe bağlı olarak, Directions hizmetinin sağlanan rotayı ara noktaları daha verimli bir sırayla yeniden düzenleyerek optimize etmesine izin vermek için optimizeWaypoints: true içinde DirectionsRequest iletebilirsiniz. (Bu optimizasyon, gezgin satıcı sorununa yönelik bir uygulamadır.) Seyahat süresi, optimize edilen birincil faktördür ancak hangi rotanın en verimli olduğuna karar verilirken mesafe, dönüş sayısı ve daha birçok faktör de dikkate alınabilir. Yol Tarifi hizmetinin rotayı optimize edebilmesi için tüm ara noktalar durak olmalıdır.

Yol tarifi hizmetine ara noktalarının sırasını optimize etmesini söylerseniz bu noktaların sırası, waypoint_order alanında DirectionsResult nesnesi içinde döndürülür.

Aşağıdaki örnekte, çeşitli başlangıç noktaları, bitiş noktaları ve ara noktalar kullanılarak ABD'deki ülkeler arası rotalar hesaplanmaktadır. (Birden fazla yol noktası seçmek için listedeki öğeleri seçerken Ctrl-tıklama tuşuna basın.) Her rotanın başlangıç ve bitiş noktasıyla ilgili metni sağlamak için routes.start_address ve routes.end_address öğelerini incelediğimizi unutmayın.

TypeScript

function initMap(): void {
  const directionsService = new google.maps.DirectionsService();
  const directionsRenderer = new google.maps.DirectionsRenderer();
  const map = new google.maps.Map(
    document.getElementById("map") as HTMLElement,
    {
      zoom: 6,
      center: { lat: 41.85, lng: -87.65 },
    }
  );

  directionsRenderer.setMap(map);

  (document.getElementById("submit") as HTMLElement).addEventListener(
    "click",
    () => {
      calculateAndDisplayRoute(directionsService, directionsRenderer);
    }
  );
}

function calculateAndDisplayRoute(
  directionsService: google.maps.DirectionsService,
  directionsRenderer: google.maps.DirectionsRenderer
) {
  const waypts: google.maps.DirectionsWaypoint[] = [];
  const checkboxArray = document.getElementById(
    "waypoints"
  ) as HTMLSelectElement;

  for (let i = 0; i < checkboxArray.length; i++) {
    if (checkboxArray.options[i].selected) {
      waypts.push({
        location: (checkboxArray[i] as HTMLOptionElement).value,
        stopover: true,
      });
    }
  }

  directionsService
    .route({
      origin: (document.getElementById("start") as HTMLInputElement).value,
      destination: (document.getElementById("end") as HTMLInputElement).value,
      waypoints: waypts,
      optimizeWaypoints: true,
      travelMode: google.maps.TravelMode.DRIVING,
    })
    .then((response) => {
      directionsRenderer.setDirections(response);

      const route = response.routes[0];
      const summaryPanel = document.getElementById(
        "directions-panel"
      ) as HTMLElement;

      summaryPanel.innerHTML = "";

      // For each route, display summary information.
      for (let i = 0; i < route.legs.length; i++) {
        const routeSegment = i + 1;

        summaryPanel.innerHTML +=
          "<b>Route Segment: " + routeSegment + "</b><br>";
        summaryPanel.innerHTML += route.legs[i].start_address + " to ";
        summaryPanel.innerHTML += route.legs[i].end_address + "<br>";
        summaryPanel.innerHTML += route.legs[i].distance!.text + "<br><br>";
      }
    })
    .catch((e) => window.alert("Directions request failed due to " + status));
}

declare global {
  interface Window {
    initMap: () => void;
  }
}
window.initMap = initMap;
index.ts

JavaScript

function initMap() {
  const directionsService = new google.maps.DirectionsService();
  const directionsRenderer = new google.maps.DirectionsRenderer();
  const map = new google.maps.Map(document.getElementById("map"), {
    zoom: 6,
    center: { lat: 41.85, lng: -87.65 },
  });

  directionsRenderer.setMap(map);
  document.getElementById("submit").addEventListener("click", () => {
    calculateAndDisplayRoute(directionsService, directionsRenderer);
  });
}

function calculateAndDisplayRoute(directionsService, directionsRenderer) {
  const waypts = [];
  const checkboxArray = document.getElementById("waypoints");

  for (let i = 0; i < checkboxArray.length; i++) {
    if (checkboxArray.options[i].selected) {
      waypts.push({
        location: checkboxArray[i].value,
        stopover: true,
      });
    }
  }

  directionsService
    .route({
      origin: document.getElementById("start").value,
      destination: document.getElementById("end").value,
      waypoints: waypts,
      optimizeWaypoints: true,
      travelMode: google.maps.TravelMode.DRIVING,
    })
    .then((response) => {
      directionsRenderer.setDirections(response);

      const route = response.routes[0];
      const summaryPanel = document.getElementById("directions-panel");

      summaryPanel.innerHTML = "";

      // For each route, display summary information.
      for (let i = 0; i < route.legs.length; i++) {
        const routeSegment = i + 1;

        summaryPanel.innerHTML +=
          "<b>Route Segment: " + routeSegment + "</b><br>";
        summaryPanel.innerHTML += route.legs[i].start_address + " to ";
        summaryPanel.innerHTML += route.legs[i].end_address + "<br>";
        summaryPanel.innerHTML += route.legs[i].distance.text + "<br><br>";
      }
    })
    .catch((e) => window.alert("Directions request failed due to " + status));
}

window.initMap = initMap;
index.js

Ara Noktalarla İlgili Sınırlar ve Kısıtlamalar

Aşağıdaki kullanım sınırları ve kısıtlamalar geçerlidir:

  • Maps JavaScript API'de Yol Tarifi hizmeti kullanılırken izin verilen maksimum ara nokta sayısı, başlangıç ve hedef noktası hariç 25'tir. Sınırlar, Directions API (Legacy) web hizmeti için de aynıdır.
  • Directions API (Eski) web hizmeti için müşterilerin başlangıç ve hedef noktaya ek olarak 25 ara nokta kullanmasına izin verilir.
  • Google Haritalar Platformu Premium Plan müşterileri, başlangıç ve hedef noktasıyla birlikte 25 ara nokta kullanabilir.
  • Toplu taşıma yol tariflerinde ara noktalar desteklenmez.

Sürüklenebilir Yol Tarifleri

Kullanıcılar, DirectionsRenderer kullanılarak gösterilen bisiklet, yürüme veya araba yol tariflerini sürükleyebiliyorlarsa dinamik olarak değiştirebilir. Bu sayede, haritada ortaya çıkan yolları tıklayıp sürükleyerek rotaları seçip değiştirebilirler. Bir oluşturucunun ekranında sürüklenebilir yol tariflerine izin verilip verilmediğini, oluşturucunun draggable özelliğini true olarak ayarlayarak belirtirsiniz. Toplu taşıma yol tarifleri sürüklenemez.

Yol tarifleri sürüklenebilir olduğunda kullanıcı, oluşturulan sonucun yolundaki (veya ara noktadaki) herhangi bir noktayı seçip belirtilen bileşeni yeni bir konuma taşıyabilir. DirectionsRenderer simgesi, değiştirilen yolu gösterecek şekilde dinamik olarak güncellenir. Yayınlandığında haritaya geçiş amaçlı bir yol noktası eklenir (küçük beyaz bir işaretçiyle gösterilir). Bir yol segmentini seçip hareket ettirmek rotanın o ayağını değiştirir. Bir ara nokta işaretçisini (başlangıç ve bitiş noktaları dahil) seçip hareket ettirmek ise rotanın o ara noktadan geçen ayaklarını değiştirir.

Sürüklenebilir rotalar istemci tarafında değiştirilip oluşturulduğundan, kullanıcı görüntülenen rotaları değiştirdiğinde bildirim almak için directions_changed etkinliğini DirectionsRenderer üzerinde izleyip işleyebilirsiniz.

Aşağıdaki kodda, Avustralya'nın batı kıyısındaki Perth'ten doğu kıyısındaki Sidney'e yapılan bir gezi gösterilmektedir. Kod, yolculuğun tüm ayaklarının toplam mesafesini güncellemek için directions_changed etkinliğini izler.

TypeScript

function initMap(): void {
  const map = new google.maps.Map(
    document.getElementById("map") as HTMLElement,
    {
      zoom: 4,
      center: { lat: -24.345, lng: 134.46 }, // Australia.
    }
  );

  const directionsService = new google.maps.DirectionsService();
  const directionsRenderer = new google.maps.DirectionsRenderer({
    draggable: true,
    map,
    panel: document.getElementById("panel") as HTMLElement,
  });

  directionsRenderer.addListener("directions_changed", () => {
    const directions = directionsRenderer.getDirections();

    if (directions) {
      computeTotalDistance(directions);
    }
  });

  displayRoute(
    "Perth, WA",
    "Sydney, NSW",
    directionsService,
    directionsRenderer
  );
}

function displayRoute(
  origin: string,
  destination: string,
  service: google.maps.DirectionsService,
  display: google.maps.DirectionsRenderer
) {
  service
    .route({
      origin: origin,
      destination: destination,
      waypoints: [
        { location: "Adelaide, SA" },
        { location: "Broken Hill, NSW" },
      ],
      travelMode: google.maps.TravelMode.DRIVING,
      avoidTolls: true,
    })
    .then((result: google.maps.DirectionsResult) => {
      display.setDirections(result);
    })
    .catch((e) => {
      alert("Could not display directions due to: " + e);
    });
}

function computeTotalDistance(result: google.maps.DirectionsResult) {
  let total = 0;
  const myroute = result.routes[0];

  if (!myroute) {
    return;
  }

  for (let i = 0; i < myroute.legs.length; i++) {
    total += myroute.legs[i]!.distance!.value;
  }

  total = total / 1000;
  (document.getElementById("total") as HTMLElement).innerHTML = total + " km";
}

declare global {
  interface Window {
    initMap: () => void;
  }
}
window.initMap = initMap;
index.ts

JavaScript

function initMap() {
  const map = new google.maps.Map(document.getElementById("map"), {
    zoom: 4,
    center: { lat: -24.345, lng: 134.46 }, // Australia.
  });
  const directionsService = new google.maps.DirectionsService();
  const directionsRenderer = new google.maps.DirectionsRenderer({
    draggable: true,
    map,
    panel: document.getElementById("panel"),
  });

  directionsRenderer.addListener("directions_changed", () => {
    const directions = directionsRenderer.getDirections();

    if (directions) {
      computeTotalDistance(directions);
    }
  });
  displayRoute(
    "Perth, WA",
    "Sydney, NSW",
    directionsService,
    directionsRenderer,
  );
}

function displayRoute(origin, destination, service, display) {
  service
    .route({
      origin: origin,
      destination: destination,
      waypoints: [
        { location: "Adelaide, SA" },
        { location: "Broken Hill, NSW" },
      ],
      travelMode: google.maps.TravelMode.DRIVING,
      avoidTolls: true,
    })
    .then((result) => {
      display.setDirections(result);
    })
    .catch((e) => {
      alert("Could not display directions due to: " + e);
    });
}

function computeTotalDistance(result) {
  let total = 0;
  const myroute = result.routes[0];

  if (!myroute) {
    return;
  }

  for (let i = 0; i < myroute.legs.length; i++) {
    total += myroute.legs[i].distance.value;
  }

  total = total / 1000;
  document.getElementById("total").innerHTML = total + " km";
}

window.initMap = initMap;
index.js
Örneği görüntüleyin

Örneği deneyin