Directions

DirectionsService sınıfı

google.maps.DirectionsService sınıf

İki veya daha fazla yer arasındaki yol tariflerini hesaplamaya yönelik bir hizmet.

const {DirectionsService} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
DirectionsService
DirectionsService()
Parametreler: Yok
Google sunucularına rota sorguları gönderen bir DirectionsService öğesinin yeni bir örneğini oluşturur.
route
route(request[, callback])
Parametreler: 
İade Değeri:  Promise<DirectionsResult>
Yol tarifi arama isteği gönderin.

DirectionsRequest arayüzü

google.maps.DirectionsRequest arayüz

DirectionsService adresine gönderilecek bir yol tarifi sorgusu.
destination
Tür:  string|LatLng|Place|LatLngLiteral
Hedefin konumu. Bu, coğrafi olarak kodlanacak bir dize, LatLng veya Place olarak belirtilebilir. Zorunlu.
origin
Tür:  string|LatLng|Place|LatLngLiteral
Kökeni Bu, coğrafi olarak kodlanacak bir dize, LatLng veya Place olarak belirtilebilir. Zorunlu.
travelMode
Tür:  TravelMode
İstenen yönlendirme türü. Zorunlu.
avoidFerries optional
Tür:  boolean optional
true, Yol Tarifi hizmetine mümkün olduğunda feribotları kullanmaması talimatını verir. İsteğe bağlı.
avoidHighways optional
Tür:  boolean optional
true seçeneği, yol tarifi hizmetine mümkün olduğunda otoyollardan kaçınma talimatı verir. İsteğe bağlı.
avoidTolls optional
Tür:  boolean optional
true, yol tarifi hizmetine mümkün olduğunda ücretli yollardan kaçınma talimatı verir. İsteğe bağlı.
drivingOptions optional
Tür:  DrivingOptions optional
Yalnızca travelMode değerinin DRIVING olduğu istekler için geçerli olan ayarlar. Bu nesne, diğer seyahat modları için geçerli değildir.
language optional
Tür:  string optional
Mümkün olduğunda sonuçların döndürülmesi gereken dilin dil tanımlayıcısı. Desteklenen dillerin listesine bakın.
optimizeWaypoints optional
Tür:  boolean optional
true olarak ayarlanırsa DirectionsService, sağlanan ara yol noktalarını yeniden sıralayarak rotanın toplam maliyetini en aza indirmeye çalışır. Ara noktalar optimize edildiyse yeni sıralamayı belirlemek için yanıttaki DirectionsRoute.waypoint_order öğesini inceleyin.
provideRouteAlternatives optional
Tür:  boolean optional
Rota alternatiflerinin sağlanıp sağlanmayacağı. İsteğe bağlı.
region optional
Tür:  string optional
Coğrafi kodlama istekleri için önyargı olarak kullanılan bölge kodu. Bölge kodu, ccTLD ("üst düzey alan") iki karakterlik değerini kabul eder. Çoğu ccTLD kodu, ISO 3166-1 kodlarıyla aynıdır ancak bazı önemli istisnalar vardır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk), ISO 3166-1 kodu ise "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" için).
transitOptions optional
Tür:  TransitOptions optional
Yalnızca travelMode değerinin TRANSIT olduğu istekler için geçerli olan ayarlar. Bu nesne, diğer seyahat modları için geçerli değildir.
unitSystem optional
Tür:  UnitSystem optional
Varsayılan: Menşe ülkede kullanılan birim sistemi.
Mesafeyi gösterirken kullanılacak tercih edilen birim sistemi.
waypoints optional
Tür:  Array<DirectionsWaypoint> optional
Ara yol noktaları dizisi. Yol tarifleri, bu dizideki her bir ara nokta üzerinden başlangıç noktasından varış noktasına doğru hesaplanır. İzin verilen maksimum ara nokta sayısı için geliştirici kılavuzuna bakın. Toplu taşıma yol tariflerinde ara noktalar desteklenmez. İsteğe bağlı.

DirectionsStatus sabitleri

google.maps.DirectionsStatus sabitler

DirectionsService tarafından route() ile yapılan bir görüşme tamamlandığında döndürülen durum. Bunları değerle veya sabitin adını kullanarak belirtebilirsiniz. Örneğin, 'OK' veya google.maps.DirectionsStatus.OK.

const {DirectionsStatus} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
INVALID_REQUEST Sağlanan DirectionsRequest geçersizdi.
MAX_WAYPOINTS_EXCEEDED DirectionsRequest içinde çok fazla DirectionsWaypoint sağlandı. İzin verilen maksimum ara nokta sayısı için geliştirici kılavuzuna bakın.
NOT_FOUND Başlangıç noktası, hedef veya ara noktalardan en az birine coğrafi kodlama uygulanamadı.
OK Yanıtta geçerli bir DirectionsResult var.
OVER_QUERY_LIMIT Web sayfası, çok kısa bir süre içinde istek sınırını aştı.
REQUEST_DENIED Web sayfasının yol tarifi hizmetini kullanmasına izin verilmiyor.
UNKNOWN_ERROR Bir yol tarifi isteği, sunucu hatası nedeniyle işlenemedi. Tekrar denerseniz istek başarılı olabilir.
ZERO_RESULTS Başlangıç ve varış noktası arasında rota bulunamadı.

DirectionsResult arayüzü

google.maps.DirectionsResult arayüz

Yol tarifi sunucusundan alınan yol tarifi yanıtı. Bunları DirectionsRenderer kullanarak oluşturabilir veya bu nesneyi ayrıştırıp kendiniz oluşturabilirsiniz. Google Haritalar Platformu Hizmet Şartları'nda belirtilen uyarıları ve telif haklarını göstermeniz gerekir. Bu sonuç "JSON benzeri" olsa da LatLng nesnelerini dolaylı olarak içerdiğinden tam olarak JSON olmadığını unutmayın.
request
Bu sonucu veren DirectionsRequest.
routes
Her biri, bacaklar ve adımlar hakkında bilgi içeren bir DirectionsRoute dizisi. DirectionsRequest, provideRouteAlternatives değeri true olarak ayarlanarak oluşturulmadığı sürece yalnızca bir rota olur.
available_travel_modes optional
Tür:  Array<TravelMode> optional
Kullanılabilecek çeşitli ulaşım şekillerini içerir. Bu alan, bir istekte seyahat modu belirtildiğinde ve sonuç alınmadığında döndürülür. Dizi, belirli bir dizi yol noktası grubunun ülkelerindeki mevcut seyahat modlarını içerir. Bu alan, bir veya daha fazla ara nokta "via ara noktası" ise döndürülmez.
geocoded_waypoints optional
Her biri başlangıç noktası, varış noktası ve ara noktaların coğrafi kodlamasıyla ilgili bilgileri içeren bir DirectionsGeocodedWaypoint dizisi.

DirectionsRenderer class

google.maps.DirectionsRenderer sınıf

DirectionsService kaynağından alınan yol tariflerini oluşturur.

Bu sınıfın süresi MVCObject tarihinde sona eriyor.

const {DirectionsRenderer} = await google.maps.importLibrary("routes") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
DirectionsRenderer
DirectionsRenderer([opts])
Parametreler: 
Belirtilen seçeneklerle oluşturucuyu oluşturur. Yol tarifleri haritada (görsel yer paylaşımları olarak) veya ek olarak <div> panelinde (metin talimatları olarak) oluşturulabilir.
getDirections
getDirections()
Parametreler: Yok
İade Değeri:  DirectionsResult
Oluşturucunun geçerli yön grubunu döndürür.
getMap
getMap()
Parametreler: Yok
İade Değeri:  Map
DirectionsResult öğesinin oluşturulduğu haritayı döndürür.
getPanel
getPanel()
Parametreler: Yok
İade Değeri:  HTMLElement|null
DirectionsResult öğesinin oluşturulduğu <div> panelini döndürür.
getRouteIndex
getRouteIndex()
Parametreler: Yok
İade Değeri:  number
Bu DirectionsRenderer nesnesi tarafından kullanılan geçerli (sıfır tabanlı) rota dizinini döndürür.
setDirections
setDirections(directions)
Parametreler: 
Döndürülen Değer: Yok
Oluşturucuyu, DirectionsService öğesinden gelen sonucu kullanacak şekilde ayarlayın. Geçerli bir dizi yönlendirmeyi bu şekilde ayarlamak, yönlendirmeleri oluşturucunun belirlenmiş haritasında ve panelinde gösterir.
setMap
setMap(map)
Parametreler: 
Döndürülen Değer: Yok
Bu yöntem, yol tariflerinin oluşturulacağı haritayı belirtir. Yol tarifini haritadan kaldırmak için null seçeneğini kullanın.
setOptions
setOptions(options)
Parametreler: 
Döndürülen Değer: Yok
Başlatma işleminden sonra bu DirectionsRenderer'nın seçenek ayarlarını değiştirin.
setPanel
setPanel(panel)
Parametreler: 
Döndürülen Değer: Yok
Bu yöntem, yol tariflerini <div> içinde oluşturur. İçeriği panelden kaldırmak için null simgesine dokunun.
setRouteIndex
setRouteIndex(routeIndex)
Parametreler: 
  • routeIndex:  number
Döndürülen Değer: Yok
Oluşturulacak DirectionsResult nesnesinde rotanın (sıfır tabanlı) dizinini ayarlayın. Varsayılan olarak, dizideki ilk rota oluşturulur.
Devralındı: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, oluşturulan yol tarifleri değiştiğinde (yeni bir DirectionsResult ayarlandığında veya kullanıcı, yol tarifi yolunda bir değişikliği sürüklemeyi bitirdiğinde) tetiklenir.

DirectionsRendererOptions arayüzü

google.maps.DirectionsRendererOptions arayüz

Bu nesne, DirectionsRenderer nesnesinde ayarlanabilecek özellikleri tanımlar.
directions optional
Tür:  DirectionsResult optional
Haritada ve/veya <div> panelinde gösterilecek yol tarifleri, DirectionsService kaynağından DirectionsResult nesnesi olarak alınır.
draggable optional
Tür:  boolean optional
true ise kullanıcının bu DirectionsRenderer tarafından oluşturulan rotaların yollarını sürükleyip değiştirmesine izin verir.
hideRouteList optional
Tür:  boolean optional
Varsayılan: false
Bu özellik, oluşturucunun yol tarifi panelinde gösterilen ve kullanıcı tarafından seçilebilen bir rota listesi sağlayıp sağlamaması gerektiğini belirtir.
infoWindow optional
Tür:  InfoWindow optional
Bir işaretçi tıklandığında metin bilgilerinin oluşturulacağı InfoWindow. Mevcut bilgi penceresi içeriğinin üzerine yazılır ve konumu taşınır. Bilgi penceresi belirtilmemişse DirectionsRenderer kendi bilgi penceresini oluşturup kullanır. suppressInfoWindows, true olarak ayarlanırsa bu özellik yoksayılır.
map optional
Tür:  Map optional
Yol tariflerinin gösterileceği harita.
markerOptions optional
Tür:  MarkerOptions optional
İşaretçilerle ilgili seçenekler. DirectionsRenderer tarafından oluşturulan tüm işaretçiler bu seçenekleri kullanır.
panel optional
Tür:  HTMLElement optional
Yol tarifi adımlarının gösterileceği <div>.
polylineOptions optional
Tür:  PolylineOptions optional
Çoklu çizgilerle ilgili seçenekler. DirectionsRenderer tarafından oluşturulan tüm çoklu çizgiler bu seçenekleri kullanır.
preserveViewport optional
Tür:  boolean optional
Varsayılan: false
Bu seçenek true olarak ayarlanırsa veya haritanın merkezi ve yakınlaştırma düzeyi hiç ayarlanmamışsa giriş haritası, bu yol tarifleri grubunun sınırlayıcı kutusuna göre ortalanır ve yakınlaştırılır.
routeIndex optional
Tür:  number optional
DirectionsResult nesnesi içindeki rotanın dizini. Varsayılan değer 0'dır.
suppressBicyclingLayer optional
Tür:  boolean optional
Bisikletle yol tarifi istendiğinde BicyclingLayer simgesinin oluşturulmasını engeller.
suppressInfoWindows optional
Tür:  boolean optional
Bilgi pencerelerinin oluşturulmasını engelleme.
suppressMarkers optional
Tür:  boolean optional
İşaretçilerin oluşturulmasını engelleme.
suppressPolylines optional
Tür:  boolean optional
Çoklu çizgilerin oluşturulmasını engeller.

DirectionsWaypoint arayüzü

google.maps.DirectionsWaypoint arayüz

DirectionsWaypoint, seyahatin yönlendirilmesi gereken, başlangıç ve varış noktası arasındaki bir konumu temsil eder.
location optional
Tür:  string|LatLng|LatLngLiteral|Place optional
Ara nokta konumu. Adres dizesi, LatLng veya Place olabilir. İsteğe bağlı.
stopover optional
Tür:  boolean optional
Varsayılan: true
true ise bu ara noktanın başlangıç ve varış noktası arasında bir durak olduğunu gösterir. Bu işlem, rotayı iki ayağa bölme etkisine sahiptir. false ise rotanın bu ara noktadan geçmesi gerektiğini ancak iki ayağa bölünmemesi gerektiğini gösterir. Kullanıcının haritada ara noktaları sürüklemesine yanıt olarak rota oluşturmak istiyorsanız bu özellikten yararlanabilirsiniz.

DirectionsGeocodedWaypoint arayüzü

google.maps.DirectionsGeocodedWaypoint arayüz

Tek bir coğrafi kodlu ara nokta.
partial_match optional
Tür:  boolean optional
Kod çözücü, istenen adresin bir kısmını eşleştirebilse de orijinal yol noktası için tam eşleşme döndürmedi.
place_id optional
Tür:  string optional
Ara nokta ile ilişkili yer kimliği. Yer kimlikleri, Google Places veritabanında ve Google Haritalar'da bir yeri benzersiz şekilde tanımlar. Places API geliştirici kılavuzunda Yer Kimlikleri hakkında daha fazla bilgi edinin.
types optional
Tür:  Array<string> optional
Döndürülen coğrafi kodlu öğenin türünü belirten bir dizeler dizisi. Olası dizelerin listesi için Geliştirici Kılavuzu'nun Adres Bileşeni Türleri bölümüne bakın.

DirectionsRoute arayüzü

google.maps.DirectionsRoute arayüz

DirectionsResult içinde bir dizi ayağı içeren tek bir rota. Bu nesne "JSON benzeri" olsa da doğrudan ve dolaylı olarak LatLng nesneleri içerdiğinden tam olarak JSON olmadığını unutmayın.
bounds
Tür:  LatLngBounds
Bu rotanın sınırları.
copyrights
Tür:  string
Bu rota için gösterilecek metinlerin telif hakları.
legs
Her biri, oluşturulduğu adımlarla ilgili bilgileri içeren bir DirectionsLeg dizisi. Belirtilen her mola noktası veya hedef için bir etap oluşturulur. Bu nedenle, aktarma noktası olmayan bir rotada bir DirectionsLeg, bir aktarma noktası olan bir rotada ise iki tane bulunur.
overview_path
Tür:  Array<LatLng>
Bu rotanın tamamını temsil eden bir LatLng dizisi. Yol, az sayıda köşe noktasının gerektiği bağlamlarda (ör. Static Maps API URL'leri) uygun olması için basitleştirilir.
overview_polyline
Tür:  string
overview_path içinde rotanın kodlanmış çoklu çizgi gösterimi. Bu çoklu çizgi, sonuçlanan yol tariflerinin yaklaşık (düzeltilmiş) yoludur.
summary
Tür:  string
Rota için kısa bir metin açıklaması içerir. Bu açıklama, rotayı adlandırmak ve alternatiflerden ayırt etmek için uygundur.
warnings
Tür:  Array<string>
Bu yol tarifleri gösterilirken gösterilecek uyarılar.
waypoint_order
Tür:  Array<number>
optimizeWaypoints, true olarak ayarlanmışsa bu alan, giriş ara noktalarının yeniden sıralanmış permütasyonunu içerir. Örneğin, giriş şu şekildeyse:
  Başlangıç: Los Angeles
  Ara noktalar: Dallas, Bangor, Phoenix
  Hedef: New York
ve optimize edilmiş çıkış şu şekilde sıralanmışsa:
  Başlangıç: Los Angeles
  Ara noktalar: Phoenix, Dallas, Bangor
  Hedef: New York
bu alan, [2, 0, 1] değerlerini içeren bir Array olur. Ara noktaların numaralandırmasının sıfır tabanlı olduğunu unutmayın.
Giriş ara noktalarından herhangi birinde stopover, false olarak ayarlanmışsa bu alan boş olur. Bunun nedeni, bu tür sorgular için rota optimizasyonunun kullanılamamasıdır.
fare optional
Tür:  TransitFare optional
Tüm toplu taşıma yolculuğunun toplam ücreti. Yalnızca toplu taşıma istekleri için geçerlidir.

DirectionsLeg arayüzü

google.maps.DirectionsLeg arayüz

DirectionsResult içinde bir dizi adımdan oluşan tek bir bacak. Bacağın bazı alanları tüm istekler için döndürülmeyebilir. Bu sonucun "JSON benzeri" olmasına rağmen doğrudan ve dolaylı olarak LatLng nesneleri içerdiğinden tam olarak JSON olmadığını unutmayın.
end_address
Tür:  string
Bu ayağın varış noktasının adresi. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adres programatik olarak ayrıştırılmamalıdır.
end_location
Tür:  LatLng
DirectionsService, başlangıç ve bitiş konumlarındaki en yakın ulaşım seçeneğini (genellikle bir yol) kullanarak konumlar arasındaki rotaları hesaplar. end_location, gerçek coğrafi kodlu hedefi gösterir. Örneğin, yol bu ayağın hedefine yakın değilse son adımın end_location değerinden farklı olabilir.
start_address
Tür:  string
Bu ayağın başlangıç noktasının adresi. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adres programatik olarak ayrıştırılmamalıdır.
start_location
Tür:  LatLng
DirectionsService, başlangıç ve bitiş konumlarındaki en yakın ulaşım seçeneğini (genellikle bir yol) kullanarak konumlar arasındaki rotaları hesaplar. start_location, gerçek coğrafi olarak kodlanmış başlangıcı gösterir. Örneğin, yol bu ayağın başlangıcının yakınında değilse bu, ilk adımın start_location değerinden farklı olabilir.
steps
Her biri bu ayağın adımlarıyla ilgili bilgileri içeren bir DirectionsStep dizisi.
traffic_speed_entry
Tür:  Array<*>
Etap boyunca trafik hızı hakkında bilgiler.
via_waypoints
Tür:  Array<LatLng>
Bu etap boyunca, orijinal istekte belirtilen, aktarmasız durak noktaları dizisi.

Alternatif rotalarda kullanımdan kaldırıldı. 3.27 sürümü, alternatif rotalara ek via_waypoints ekleyen son API sürümü olacaktır.

Sürüklenerek taşınabilen yol tarifleri uygulamak için Directions Service'i kullanırken alternatif rotaların sürüklenerek taşınmasını devre dışı bırakmanız önerilir. 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.
arrival_time optional
Tür:  Time optional
Bu etap için tahmini varış zamanı. Yalnızca TRANSIT istekleri için geçerlidir.
departure_time optional
Tür:  Time optional
Bu etap için tahmini kalkış saati. Yalnızca TRANSIT istekleri için geçerlidir.
distance optional
Tür:  Distance optional
Bu etapta katedilen toplam mesafe. Mesafe bilinmeyebileceğinden bu özellik tanımlanmamış olabilir.
duration optional
Tür:  Duration optional
Bu ayağın toplam süresi. Süre bilinmeyebileceğinden bu özellik undefined olabilir.
duration_in_traffic optional
Tür:  Duration optional
trafficModel özelliğiyle belirtilen trafik koşulları dikkate alınarak bu ayağın toplam süresi. Süre bilinmeyebileceğinden bu özellik undefined olabilir.

DirectionsStep arayüzü

google.maps.DirectionsStep arayüz

DirectionsResult içinde tek bir DirectionsStep. Bazı alanlar undefined olabilir. Bu nesne "JSON benzeri" olsa da doğrudan LatLng nesneleri içerdiğinden tam olarak JSON olmadığını unutmayın.
encoded_lat_lngs
Tür:  string
Adımın kodlanmış çoklu çizgi gösterimi. Bu, adımın yaklaşık (düzeltilmiş) yoludur.
end_location
Tür:  LatLng
Bu adımın bitiş konumu.
end_point
Tür:  LatLng
Bu adımın bitiş konumu.
instructions
Tür:  string
Bu adımla ilgili talimatlar.
lat_lngs
Tür:  Array<LatLng>
Bu adımın sürecini açıklayan bir LatLng dizisi. Bu, adımın yaklaşık (düzeltilmiş) yoludur.
maneuver
Tür:  string
Mevcut adımda (turn-left, merge, straight vb.) yapılması gereken işlemi içerir. Değerler değişebilir ve önceden haber verilmeksizin yeni değerler eklenebilir.
path
Tür:  Array<LatLng>
Bu adımın sürecini açıklayan bir LatLng dizisi. Bu, adımın yaklaşık (düzeltilmiş) yoludur.
start_location
Tür:  LatLng
Bu adımın başlangıç konumu.
start_point
Tür:  LatLng
Bu adımın başlangıç konumu.
travel_mode
Tür:  TravelMode
Bu adımda kullanılan ulaşım şekli.
distance optional
Tür:  Distance optional
Bu adımda katedilen mesafe. Mesafe bilinmiyor olabileceğinden bu özellik undefined olabilir.
duration optional
Tür:  Duration optional
Bu adımın gerçekleştirilmesi için gereken tipik süre (saniye cinsinden ve metin biçiminde). Süre bilinmeyebileceğinden bu özellik undefined olabilir.
polyline optional
Tür:  DirectionsPolyline optional
Adımın kodlanmış çoklu çizgi gösterimini içeren tek bir özelliği ("points") olan bir nesne içerir. Bu çoklu çizgi, adımın yaklaşık (düzeltilmiş) yoludur.
steps optional
Tür:  Array<DirectionsStep> optional
Bu adımın alt adımları. Toplu taşıma rotalarının toplu taşıma dışı bölümleri için belirtilir.
transit optional
Tür:  TransitDetails optional
Bu adımla ilgili toplu taşıma araçlarına özel ayrıntılar. Bu adımın seyahat modu TRANSIT olmadığı sürece bu özellik tanımlanmamış olur.
transit_details optional
Tür:  TransitDetails optional
Seyahat modu TRANSIT ise bu adımla ilgili ayrıntılar.

DirectionsPolyline arayüzü

google.maps.DirectionsPolyline arayüz

Bir points öğesi içeren nesne,