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: 
  • routeIndexnumber
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: