DirectionsService sınıfı
google.maps.DirectionsService
sınıf
kitaplık "routes"
const {DirectionsService} = await google.maps.importLibrary("routes");
Marka | |
|---|---|
DirectionsService |
DirectionsService()Parametreler: Yok
Google sunucularına yol tarifi sorguları gönderen yeni bir DirectionsService örneği oluşturur. |
Yöntemler | |
|---|---|
route |
route(request[, callback])Parametreler:
Dönüş Değeri:
Promise<DirectionsResult>Yol tarifi arama isteği gönderin. |
DirectionsRequest arayüzü
google.maps.DirectionsRequest
arayüz
DirectionsService uygulamasına gönderilecek yol tarifi sorgusu.
Özellikler | |
|---|---|
destination |
Tür:
string|LatLng|Place|LatLngLiteralHedefin konumu. Bu, coğrafi kodlanacak bir dize, LatLng veya Place olarak belirtilebilir. Zorunlu. |
origin |
Tür:
string|LatLng|Place|LatLngLiteralBaşlangıç noktası konumu. Bu, coğrafi kodlanacak bir dize, LatLng veya Place olarak belirtilebilir. Zorunlu. |
travelMode |
Tür:
TravelModeİstenen yönlendirme türü. Zorunlu. |
avoidFerries
isteğe bağlı |
Tür:
boolean optionaltrue ise Yol Tarifi hizmetine mümkün olduğunda feribotları kullanmamasını söyler. İsteğe bağlıdır. |
avoidHighways
isteğe bağlı |
Tür:
boolean optionaltrue ise Yol Tarifi hizmetine mümkün olduğunda otoyollardan kaçınmasını söyler. İsteğe bağlıdır. |
avoidTolls
isteğe bağlı |
Tür:
boolean optionaltrue ise Directions hizmetine, mümkün olduğunda paralı yollardan kaçınması talimatını verir. İsteğe bağlıdır. |
drivingOptions
isteğe bağlı |
Tür:
DrivingOptions optionalYalnızca travelMode değerinin DRIVING olduğu istekler için geçerli olan ayarlar. Bu nesnenin diğer seyahat modları üzerinde herhangi bir etkisi olmaz. |
language
isteğe bağlı |
Tür:
string optionalMümkün olduğunda sonuçların döndürülmesi gereken dil için bir dil tanımlayıcı. Desteklenen dillerin listesine bakın. |
optimizeWaypoints
isteğe bağlı |
Tür:
boolean optionaltrue olarak ayarlanırsa DirectionsService, rotanın toplam maliyetini en aza indirmek için sağlanan ara noktaları yeniden sıralamaya çalışır. Ara noktalar optimize edilmişse yeni sıralamayı belirlemek için yanıttaki DirectionsRoute.waypoint_order değerini inceleyin. |
provideRouteAlternatives
isteğe bağlı |
Tür:
boolean optionalAlternatif rotaların sağlanıp sağlanmayacağı. İsteğe bağlıdır. |
region
isteğe bağlı |
Tür:
string optionalCoğrafi kodlama istekleri için bir önyargı olarak kullanılan bölge kodu. Bölge kodu, iki karakterli bir ccTLD ("üst düzey alan") değerini kabul eder. Çoğu ccTLD kodu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" ( .co.uk) iken ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" tüzel kişiliği için). |
transitOptions
isteğe bağlı |
Tür:
TransitOptions optionalYalnızca travelMode değerinin TRANSIT olduğu istekler için geçerli olan ayarlar. Bu nesnenin diğer seyahat modları üzerinde herhangi bir etkisi olmaz. |
unitSystem
isteğe bağlı |
Tür:
UnitSystem optionalVarsayılan: Menşe ülkede kullanılan birim sistemi.
Mesafe gösterilirken kullanılacak tercih edilen birim sistemi. |
waypoints
isteğe bağlı |
Tür:
Array<DirectionsWaypoint> optionalAra noktalar dizisi. Yol tarifleri, bu dizideki her bir yol noktası üzerinden başlangıç noktasından varış noktasına kadar hesaplanır. İzin verilen maksimum yol noktası sayısı için geliştirici kılavuzuna bakın. Toplu taşıma yol tarifinde ara noktalar desteklenmez. İsteğe bağlıdır. |
DirectionsStatus sabitleri
google.maps.DirectionsStatus
sabitleri
kitaplığı "routes"
route() çağrısı tamamlandığında DirectionsService tarafından döndürülen durum. Bunları değere göre veya sabitin adını kullanarak belirtin. Örneğin, 'OK' veya google.maps.DirectionsStatus.OK.
Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri DirectionsStatusString türüyle tanımlanır.
const {DirectionsStatus} = await google.maps.importLibrary("routes");
Sabitler | |
|---|---|
INVALID_REQUEST |
Sağlanan DirectionsRequest geçersizdi. |
MAX_WAYPOINTS_EXCEEDED |
DirectionsRequest içinde çok fazla DirectionsWaypoint sağlandı. İzin verilen maksimum yol noktası sayısı için geliştirici kılavuzuna bakın. |
NOT_FOUND |
Başlangıç noktası, hedef veya ara noktalardan en az biri coğrafi olarak kodlanamadı. |
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şmıştır. |
REQUEST_DENIED |
Web sayfasının yol tarifi hizmetini kullanmasına izin verilmiyor. |
UNKNOWN_ERROR |
Sunucu hatası nedeniyle yol tarifi isteği 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 sonucun "JSON benzeri" olmasına rağmen, dolaylı olarak LatLng nesneleri içerdiğinden tam olarak JSON olmadığını unutmayın.
Özellikler | |
|---|---|
request |
Tür:
DirectionsRequestBu sonucu veren DirectionsRequest. |
routes |
Tür:
Array<DirectionsRoute>Her biri, oluşturduğu ayaklar ve adımlar hakkında bilgi içeren bir DirectionsRoute dizisi. DirectionsRequest, provideRouteAlternatives true olarak ayarlanarak oluşturulmadığı sürece yalnızca bir rota olur. |
available_travel_modes
isteğe bağlı |
Tür:
Array<TravelMode> optionalKullanılabilir seyahat modlarının dizisini içerir. Bu alan, bir istekte seyahat modu belirtildiğinde ve sonuç alınmadığında döndürülür. Dizi, belirli yol noktası grubunun ülkelerinde kullanılabilen seyahat modlarını içerir. Ara noktalardan biri veya daha fazlası "ara nokta üzerinden" ise bu alan döndürülmez. |
geocoded_waypoints
isteğe bağlı |
Tür:
Array<DirectionsGeocodedWaypoint> optionalHer biri başlangıç, varış ve ara noktaların coğrafi kodlaması hakkında bilgi içeren bir DirectionsGeocodedWaypoint dizisi. |
DirectionsRenderer sınıfı
google.maps.DirectionsRenderer
sınıfı
MVCObject
kitaplığını "routes"genişletir
const {DirectionsRenderer} = await google.maps.importLibrary("routes");
Marka | |
|---|---|
DirectionsRenderer |
DirectionsRenderer([opts])Parametreler:
Oluşturucuyu verilen seçeneklerle oluşturur. Yol tarifleri bir harita üzerinde (görsel yer paylaşımları olarak) veya ek olarak bir <div> panelinde (metin talimatları olarak) oluşturulabilir. |
Yöntemler | |
|---|---|
getDirections |
getDirections()Parametreler: Yok
Dönüş Değeri:
DirectionsResult|nullOluşturucunun geçerli yol tarifi grubunu döndürür. |
getMap |
getMap()Parametreler: Yok
Dönüş Değeri:
Map|nullDirectionsResult öğesinin oluşturulduğu haritayı döndürür. |
getPanel |
getPanel()Parametreler: Yok
Dönüş Değeri:
HTMLElement|nullDirectionsResult öğesinin oluşturulduğu <div> panelini döndürür. |
getRouteIndex |
getRouteIndex()Parametreler: Yok
Dönüş Değeri:
numberBu DirectionsRenderer nesnesi tarafından kullanılan mevcut (sıfır tabanlı) rota dizinini döndürür. |
setDirections |
setDirections(directions)Parametreler:
Döndürülen değer: Yok
Oluşturucuyu, DirectionsService sonucunu kullanacak şekilde ayarlayın. Geçerli bir yol tarifi grubu bu şekilde ayarlandığında, yol tarifleri oluşturucunun belirlenen haritasında ve panelinde gösterilir. |
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 geçin. |
setOptions |
setOptions(options)Parametreler:
Döndürülen değer: Yok
Başlatma işleminden sonra bu DirectionsRenderer öğesinin 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 kartını kullanın. |
setRouteIndex |
setRouteIndex(routeIndex)Parametreler:
Döndürülen değer: Yok
Oluşturulacak DirectionsResult nesnesindeki rotanın (sıfır tabanlı) dizinini ayarlayın. Varsayılan olarak, dizideki ilk rota oluşturulur. |
Devralınan:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
Etkinlikler | |
|---|---|
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 tamamladığında) tetiklenir. |
DirectionsRendererOptions arayüzü
google.maps.DirectionsRendererOptions
arayüz
Bu nesne, DirectionsRenderer nesnesinde ayarlanabilecek özellikleri tanımlar.
Özellikler | |
|---|---|
directions
isteğe bağlı |
Tür:
DirectionsResult optionalHaritada ve/veya <div> panelinde gösterilecek yol tarifleri, DirectionsService üzerinden DirectionsResult nesnesi olarak alınır. |
draggable
isteğe bağlı |
Tür:
boolean optionaltrue ise kullanıcının bu DirectionsRenderer tarafından oluşturulan rotaların yollarını sürükleyip değiştirmesine olanak tanır. |
hideRouteList
isteğe bağlı |
Tür:
boolean optionalVarsayılan:
falseBu özellik, oluşturucunun yol tarifi panelinde gösterilen rotaların kullanıcı tarafından seçilebilir bir listesini sağlayıp sağlamayacağını belirtir. |
infoWindow
isteğe bağlı |
Tür:
InfoWindow optionalBir 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 belirtilmezse DirectionsRenderer kendi bilgi penceresini oluşturur ve kullanır. suppressInfoWindows, true olarak ayarlanırsa bu özellik yoksayılır. |
map
isteğe bağlı |
Tür:
Map optionalYol tariflerinin gösterileceği harita. |
markerOptions
isteğe bağlı |
Tür:
MarkerOptions optionalİşaretçiler için seçenekler. DirectionsRenderer tarafından oluşturulan tüm işaretçiler bu seçenekleri kullanır. |
panel
isteğe bağlı |
Tür:
HTMLElement optionalYol tarifi adımlarının gösterileceği <div>. |
polylineOptions
isteğe bağlı |
Tür:
PolylineOptions optionalÇoklu çizgiler için seçenekler. DirectionsRenderer tarafından oluşturulan tüm çoklu çizgiler bu seçenekleri kullanır. |
preserveViewport
isteğe bağlı |
Tür:
boolean optionalVarsayılan:
falseBu seçenek true değerine ayarlanırsa veya haritanın merkezi ve yakınlaştırma düzeyi hiç ayarlanmadıysa giriş haritası, bu yol tarifi grubunun sınırlayıcı kutusuna göre ortalanır ve yakınlaştırılır. |
routeIndex
isteğe bağlı |
Tür:
number optionalDirectionsResult nesnesindeki rotanın dizini. Varsayılan değer 0'dır. |
suppressBicyclingLayer
isteğe bağlı |
Tür:
boolean optionalBisiklet için yol tarifi istendiğinde BicyclingLayer oluşturulmasını engeller. |
suppressInfoWindows
isteğe bağlı |
Tür:
boolean optionalBilgi pencerelerinin oluşturulmasını engelleme |
suppressMarkers
isteğe bağlı |
Tür:
boolean optionalİşaretçilerin oluşturulmasını engelleme |
suppressPolylines
isteğe bağlı |
Tür:
boolean optionalÇoklu çizgilerin oluşturulmasını engeller. |
DirectionsWaypoint interface
google.maps.DirectionsWaypoint
arayüz
DirectionsWaypoint, başlangıç ve varış noktası arasında, gezinin yönlendirilmesi gereken bir konumu temsil eder.
Özellikler | |
|---|---|
location
isteğe bağlı |
Tür:
string|LatLng|LatLngLiteral|Place optionalAra nokta konumu. Adres dizesi, LatLng veya Place olabilir. İsteğe bağlıdır. |
stopover
isteğe bağlı |
Tür:
boolean optionalVarsayılan:
truetrue 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öler. false ise rotanın bu ara noktadan geçecek şekilde ayarlanması ancak iki ayağa bölünmemesi gerektiğini gösterir. Bu, kullanıcının harita üzerinde ara noktaları sürüklemesine yanıt olarak bir rota oluşturmak istediğinizde kullanışlıdır. |
DirectionsGeocodedWaypoint arayüzü
google.maps.DirectionsGeocodedWaypoint
arayüz
Coğrafi olarak kodlanmış tek bir yol noktası.
Özellikler | |
|---|---|
partial_match
isteğe bağlı |
Tür:
boolean optionalCoğrafi kodlayıcının, istenen adresin bir kısmını eşleştirebilmesine rağmen orijinal ara nokta için tam eşleşme döndürüp döndürmediği. |
place_id
isteğe bağlı |
Tür:
string optionalAra nokta ile ilişkili yer kimliği. Yer kimlikleri, Google Rehber 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 edinebilirsiniz. |
types
isteğe bağlı |
Tür:
Array<string> optionalCoğrafi kodlanmış öğenin türünü belirten dize 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 bacak içeren tek bir rota. Bu nesne "JSON benzeri" olsa da doğrudan ve dolaylı olarak LatLng nesneleri içerdiğinden tam olarak JSON değildir.
Özellikler | |
|---|---|
bounds |
Tür:
LatLngBoundsBu rotanın sınırları. |
copyrights |
Tür:
stringBu rota için gösterilecek telif hakkı metni. |
legs |
Tür:
Array<DirectionsLeg>Her biri, oluşturulduğu adımlarla ilgili bilgileri içeren bir DirectionsLeg dizisi. Belirtilen her mola noktası veya hedef için bir ayak olur. Bu nedenle, mola ara noktası olmayan bir rota bir DirectionsLeg, bir mola ara noktası olan rota ise iki içerir. |
overview_path |
Bu rotanın tüm rotasını temsil eden bir LatLng dizisi. Yol, az sayıda köşe gerektiren bağlamlara (ör. Static Maps API URL'leri) uygun hale getirmek için basitleştirilir. |
overview_polyline |
Tür:
stringoverview_path içinde rotanın kodlanmış çoklu çizgi gösterimi. Bu çoklu çizgi, elde edilen yol tariflerinin yaklaşık (düzeltilmiş) bir yoludur. |
summary |
Tür:
stringRota 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örüntülenecek uyarılar. |
waypoint_order |
Tür:
Array<number>optimizeWaypoints, true olarak ayarlanmışsa bu alan, giriş noktalarının yeniden sıralanmış permütasyonunu içerir. Örneğin, giriş şu şekildeyse:Başlangıç: Los Angeles Ara noktalar: Dallas, Bangor, Phoenix Varış noktası: New York ve optimize edilmiş çıkış şu şekilde sıralanmışsa: Başlangıç: Los Angeles Ara noktalar: Phoenix, Dallas, Bangor Varış noktası: 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ş yol noktalarından herhangi birinde stopover, false olarak ayarlanmışsa rota optimizasyonu bu tür sorgular için kullanılamadığından bu alan boş olur. |
fare
isteğe bağlı |
Tür:
TransitFare optionalTü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 ayak. Ayaktaki bazı alanlar tüm istekler için döndürülmeyebilir. Bu sonuç "JSON benzeri" olsa da doğrudan ve dolaylı olarak LatLng nesneleri içerdiğinden tam olarak JSON değildir.
Özellikler | |
|---|---|
end_address |
Tür:
stringBu ayağın varış noktasının adresi. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adresi programatik olarak ayrıştırmayın. |
end_location |
Tür:
LatLngDirectionsService, başlangıç ve bitiş konumlarındaki en yakın ulaşım seçeneğini (genellikle bir yol) kullanarak konumlar arasındaki yol tariflerini hesaplar. end_location, coğrafi olarak kodlanmış gerçek varış noktasını gösterir. Örneğin, yol bu ayağın varış noktasına yakın değilse son adımın end_location değerinden farklı olabilir. |
start_address |
Tür:
stringBu ayağın başlangıç noktasının adresi. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adresi programatik olarak ayrıştırmayın. |
start_location |
Tür:
LatLngDirectionsService, başlangıç ve bitiş konumlarındaki en yakın ulaşım seçeneğini (genellikle bir yol) kullanarak konumlar arasındaki yol tariflerini hesaplar. start_location, coğrafi olarak kodlanmış gerçek başlangıç noktasını gösterir. Örneğin, yol bu ayağın başlangıç noktasına yakın değilse ilk adımın start_location değerinden farklı olabilir. |
steps |
Tür:
Array<DirectionsStep>Her biri bu ayaktaki bağımsız adımlarla ilgili bilgileri içeren bir DirectionsStep dizisi. |
|
Tür:
Array<*>Etap boyunca trafik hızıyla ilgili bilgiler. |
via_waypoints |
Bu ayakta, orijinal istekte belirtilen aktarmasız ara noktalar dizisi. Alternatif rotalarda desteği sonlandırıldı. Sürüm 3.27, alternatif rotalara fazladan Sürüklenebilir yol tarifleri uygulamak için Yol Tarifi Hizmeti'ni kullanırken alternatif rotaların sürüklenmesini 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
isteğe bağlı |
Tür:
Time optionalBu ayağın tahmini varış zamanı. Yalnızca TRANSIT istekleri için geçerlidir. |
departure_time
isteğe bağlı |
Tür:
Time optionalBu aşama için tahmini kalkış saati. Yalnızca TRANSIT istekleri için geçerlidir. |
distance
isteğe bağlı |
Tür:
Distance optionalBu ayağın kapsadığı toplam mesafe. Mesafe bilinmeyebileceğinden bu özellik tanımlanmamış olabilir. |
duration
isteğe bağlı |
Tür:
Duration optionalBu ayağın toplam süresi. Süre bilinmeyebileceğinden bu özellik undefined olabilir. |
duration_in_traffic
isteğe bağlı |
Tür:
Duration optionaltrafficModel ö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 değildir.
Özellikler | |
|---|---|
encoded_lat_lngs |
Tür:
stringAdımın kodlanmış çoklu çizgi temsili. Bu, adımın yaklaşık (düzeltilmiş) yoludur. |
end_location |
Tür:
LatLngBu adımın bitiş konumu. |
|
Tür:
LatLngBu adımın bitiş konumu. |
instructions |
Tür:
stringBu adımla ilgili talimatlar. |
|
Bu adımın ilerleyişini açıklayan LatLng dizisi. Bu, adımın yaklaşık (düzeltilmiş) yoludur. |
maneuver |
Tür:
stringMevcut adım için yapılacak işlemi ( turn-left, merge, straight vb.) içerir. Değerler değişebilir ve önceden bildirimde bulunulmadan yeni değerler eklenebilir. |
path |
Bu adımın ilerleyişini açıklayan LatLng dizisi. Bu, adımın yaklaşık (düzeltilmiş) yoludur. |
start_location |
Tür:
LatLngBu adımın başlangıç konumu. |
|
Tür:
LatLngBu adımın başlangıç konumu. |
travel_mode |
Tür:
TravelModeBu adımda kullanılan seyahat modu. |
distance
isteğe bağlı |
Tür:
Distance optionalBu adımın kapsadığı mesafe. Mesafe bilinmeyebileceğinden bu özellik undefined olabilir. |
duration
isteğe bağlı |
Tür:
Duration optionalBu adımın gerçekleştirilmesi için gereken normal süre (saniye cinsinden ve metin biçiminde). Süre bilinmeyebileceğinden bu özellik undefined olabilir. |
isteğe bağlı |
Tür:
DirectionsPolyline optionalAdımın kodlanmış çoklu çizgi temsilini içeren tek bir "points" özelliğine sahip bir nesne içerir. Bu çoklu çizgi, adımın yaklaşık (düzleştirilmiş) yoludur. |
steps
isteğe bağlı |
Tür:
Array<DirectionsStep> optionalBu adımın alt adımları. Toplu taşıma rotalarının toplu taşıma dışındaki bölümleri için belirtilir. |
transit
isteğe bağlı |
Tür:
TransitDetails optionalBu adımla ilgili toplu taşımaya özgü ayrıntılar. Bu adımın seyahat modu TRANSIT değilse bu özellik tanımlanmaz. |
transit_details
isteğe bağlı |
Tür:
TransitDetails optionalSeyahat modu TRANSIT ise bu adımla ilgili ayrıntılar. |
DirectionsPolyline arayüzü
google.maps.DirectionsPolyline
arayüz
Bir DirectionsStep öğesinin çoklu çizgisini açıklayan points özelliğini içeren bir nesne.
Özellikler | |
|---|---|
points |
Tür:
string |
Place arayüzü
google.maps.Place
arayüz
DirectionsRequest veya DistanceMatrixRequest için bir yeri bulmak, tanımlamak veya açıklamak için gereken bilgileri içerir. Bu bağlamda "yer", bir işletme, önemli yer veya coğrafi konum anlamına gelir. Bir yerle ilgili bilgi almak için PlacesService sayfasına bakın.
Özellikler | |
|---|---|
location
isteğe bağlı |
Tür:
LatLng|LatLngLiteral optionalBu yer tarafından açıklanan tüzel kişinin LatLng. |
placeId
isteğe bağlı |
Tür:
string optionalYerin (ör. işletme veya önemli yer) yer kimliği. Yer kimliği, Google Haritalar veritabanındaki bir yerin benzersiz tanımlayıcısıdır. placeId, bir yeri tanımlamanın en doğru yoludur. Mümkünse query yerine placeId belirtmeniz gerekir. Yer kimliği, Places API'ye gönderilen herhangi bir istekten (ör. TextSearch) alınabilir. Yer kimlikleri, Geocoding API'ye gönderilen isteklerden de alınabilir. Daha fazla bilgi için yer kimliklerine genel bakış başlıklı makaleyi inceleyin. |
query
isteğe bağlı |
Tür:
string optionalYeri (ör. işletme veya önemli yer) açıklayan bir arama sorgusu. Örnek sorgu: "Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW". Mümkünse query yerine placeId belirtmeniz gerekir. API, sorgu dizesinin bir yere çözümlenmesinin doğruluğunu garanti etmez. Hem placeId hem de query sağlanırsa hata oluşur. |
TravelMode sabitleri
google.maps.TravelMode
sabitleri
kitaplığı "routes"
DirectionsRequest içinde belirtilebilecek geçerli seyahat modları ve DirectionsStep içinde döndürülen seyahat modları. Bunları değere göre veya sabitin adını kullanarak belirtin. Örneğin, 'BICYCLING' veya google.maps.TravelMode.BICYCLING.
Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri TravelModeString türüyle tanımlanır.
const {TravelMode} = await google.maps.importLibrary("routes");
Sabitler | |
|---|---|
BICYCLING |
Bisiklet için yol tarifi isteğini belirtir. |
DRIVING |
Arabayla yol tarifi isteğini belirtir. |
TRANSIT |
Toplu taşıma yol tarifi isteğini belirtir. |
|
İki tekerlekli araçlar için yol tarifi isteğini belirtir. |
WALKING |
Yaya yol tarifi isteğini belirtir. |
DrivingOptions arayüzü
google.maps.DrivingOptions
arayüz
Seyahat modu DRIVING olarak ayarlandığında DirectionsRequest yapılandırır.
Özellikler | |
|---|---|
departureTime |
Tür:
DateRota için istenen kalkış saati ( Date nesnesi olarak belirtilir). Date nesnesi, 1 Ocak 1970'ten itibaren zamanı milisaniye cinsinden ölçer. DrivingOptions öğesinin geçerli olması için bu değerin belirtilmesi gerekir. Kalkış saati, geçerli saate veya gelecekteki bir saate ayarlanmalıdır. Geçmişte olamaz. |
trafficModel
isteğe bağlı |
Tür:
TrafficModel optionalTrafikteki süreyi tahmin ederken kullanılacak tercih edilen varsayım. Varsayılan değer: BEST_GUESS. |
TrafficModel sabitleri
google.maps.TrafficModel
sabitleri
kitaplığı "routes"
Trafikteki süreyi tahmin ederken kullanılacak varsayımlar. DirectionsRequest veya DistanceMatrixRequest kapsamında belirtilir. Bunları değere göre veya sabitin adını kullanarak belirtin. Örneğin, 'bestguess' veya google.maps.TrafficModel.BEST_GUESS.
Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri TrafficModelString türüyle tanımlanır.
const {TrafficModel} = await google.maps.importLibrary("routes");
Sabitler | |
|---|---|
BEST_GUESS |
Trafikte geçirilen süreyi en iyi şekilde tahmin etmek için geçmiş trafik verilerini kullanır. |
OPTIMISTIC |
Trafikteki sürenin ne olacağına dair iyimser bir tahminde bulunmak için geçmiş trafik verilerini kullanır. |
PESSIMISTIC |
Trafikteki sürenin ne olacağına dair kötümser bir tahminde bulunmak için geçmiş trafik verilerini kullanın. |
TransitOptions arayüzü
google.maps.TransitOptions
arayüz
Seyahat modu TRANSIT olarak ayarlandığında DirectionsRequest öğesine dahil edilecek TransitOptions nesnesi.
Özellikler | |
|---|---|
arrivalTime
isteğe bağlı |
Tür:
Date optionalRota için istenen varış zamanı, Date nesnesi olarak belirtilir. Date nesnesi, 1 Ocak 1970'ten itibaren geçen süreyi milisaniye cinsinden ölçer. Varış zamanı belirtilirse kalkış zamanı yok sayılır. |
departureTime
isteğe bağlı |
Tür:
Date optionalRota için istenen kalkış saati (Date nesnesi olarak belirtilir). Date nesnesi, 1 Ocak 1970'ten itibaren geçen süreyi milisaniye cinsinden ölçer. Kalkış saati veya varış saati belirtilmezse saatin "şimdi" olduğu varsayılır. |
modes
isteğe bağlı |
Tür:
Array<TransitMode> optionalOtobüs veya tren gibi bir ya da daha fazla tercih edilen toplu taşıma modu. Herhangi bir tercih belirtilmezse API, varsayılan en iyi rotayı döndürür. |
routingPreference
isteğe bağlı |
Tür:
TransitRoutePreference optionalToplu taşıma rotası seçimini etkileyebilecek bir tercih (ör. daha az yürüyüş). Herhangi bir tercih belirtilmezse API, varsayılan en iyi rotayı döndürür. |
TransitMode sabitleri
google.maps.TransitMode
sabitleri
kitaplığı "routes"
TransitOptions içinde belirtilebilecek geçerli toplu taşıma modu (ör. otobüs). Bunları değere göre veya sabitin adını kullanarak belirtin. Örneğin, 'BUS' veya google.maps.TransitMode.BUS.
Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri TransitModeString türüyle tanımlanır.
const {TransitMode} = await google.maps.importLibrary("routes");
Sabitler | |
|---|---|
BUS |
Tercih edilen toplu taşıma modu olarak otobüsü belirtir. |
|
Hafif raylı sistemi tercih edilen toplu taşıma modu olarak belirtir. |
RAIL |
Tercih edilen toplu taşıma modu olarak demir yolunu belirtir. |
SUBWAY |
Tercih edilen toplu taşıma modu olarak metroyu belirtir. |
TRAIN |
Tercih edilen toplu taşıma modu olarak treni belirtir. |
TRAM |
Tercih edilen toplu taşıma modu olarak tramvayı belirtir. |
TransitRoutePreference sabitleri
google.maps.TransitRoutePreference
sabitleri
kitaplığı "routes"
TransitOptions içinde belirtilebilecek geçerli toplu taşıma rotası türü. Bunları değere göre veya sabitin adını kullanarak belirtin. Örneğin, 'LESS_WALKING' veya google.maps.TransitRoutePreference.LESS_WALKING.
Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri TransitRoutePreferenceString türüyle tanımlanır.
const {TransitRoutePreference} = await google.maps.importLibrary("routes");
Sabitler | |
|---|---|
FEWER_TRANSFERS |
Hesaplanan rotada sınırlı sayıda aktarma tercih edilmesi gerektiğini belirtir. |
LESS_WALKING |
Hesaplanan rotada sınırlı miktarda yürüyüş tercih edilmesi gerektiğini belirtir. |
TransitFare arayüzü
google.maps.TransitFare
arayüz
Değer ve para biriminden oluşan DirectionsRoute ücreti.
Özellikler | |
|---|---|
currency |
Tür:
stringÜcretin ifade edildiği para birimini gösteren ISO 4217 para birimi kodu. |
text |
Tür:
stringÜcretin değeri, dize olarak belirtilen currency cinsinden ifade edilir. |
value |
Tür:
numberÜcretin sayısal değeri, belirtilen currency cinsinden ifade edilir. |
TransitDetails arayüzü
google.maps.TransitDetails
arayüz
Bu adımda kullanılan kalkış, varış ve toplu taşıma moduyla ilgili ayrıntılar.
Özellikler | |
|---|---|
arrival_stop |
Tür:
TransitStopBu toplu taşıma adımının varış durağı. |
arrival_time |
Tür:
TimeBu adımın varış zamanı (Time nesnesi olarak belirtilir). |
departure_stop |
Tür:
TransitStopBu toplu taşıma adımının kalkış durağı. |
departure_time |
Tür:
TimeBu adımın kalkış saati (Time nesnesi olarak belirtilir). |
headsign |
Tür:
stringAraçta veya kalkış durağında işaretlendiği şekilde bu hat üzerinde seyahat edilecek yön. |
headway |
Tür:
numberBu durakta eşdeğer araçlar arasında beklenen saniye sayısı. |
line |
Tür:
TransitLineBu adımda kullanılan toplu taşıma hattıyla ilgili ayrıntılar. |
num_stops |
Tür:
numberBu adımdaki durak sayısı. Varış durağını içerir ancak kalkış durağını içermez. |
trip_short_name |
Tür:
stringYolculara toplu taşıma seferlerini tanımlamak için tarifelerde ve tabelalarda görünen metin (ör. banliyö treni seferleri için tren numaralarını tanımlamak amacıyla). Metin, bir hizmet günü içindeki bir geziyi benzersiz şekilde tanımlar. |
TransitStop arayüzü
google.maps.TransitStop
arayüz
Toplu taşıma durağı veya istasyonuyla ilgili ayrıntılar.
Özellikler | |
|---|---|
location |
Tür:
LatLngBu durağın konumu. |
name |
Tür:
stringBu toplu taşıma durağının adı. |
TransitLine arayüzü
google.maps.TransitLine
arayüz
Bu toplu taşıma adımını işleten toplu taşıma hattı hakkında bilgi.
Özellikler | |
|---|---|
agencies |
Tür:
Array<TransitAgency>Bu toplu taşıma hattını işleten transit operatörü. |
color |
Tür:
stringBu toplu taşıma hattının tabelalarında yaygın olarak kullanılan renk (onaltılık dize olarak gösterilir). |
icon |
Tür:
stringBu satırla ilişkili bir simgenin URL'si. |
name |
Tür:
stringBu toplu taşıma hattının tam adı (ör. "8 Avenue Local"). |
short_name |
Tür:
stringBu toplu taşıma hattının kısa adı (ör. "E"). |
text_color |
Tür:
stringBu toplu taşıma hattının tabelalarında yaygın olarak kullanılan metin rengi (onaltılık dize olarak gösterilir). |
url |
Tür:
stringKurumun bu toplu taşıma hattına özel URL'si. |
vehicle |
Tür:
TransitVehicleKullanılan aracın türü (ör. tren veya otobüs). |
TransitAgency arayüzü
google.maps.TransitAgency
arayüz
Toplu taşıma hattını işleten kurum hakkında bilgi.
Özellikler | |
|---|---|
name |
Tür:
stringBu transit operatörünün adı. |
phone |
Tür:
stringToplu taşıma şirketinin telefon numarası. |
url |
Tür:
stringToplu taşıma şirketinin URL'si. |
TransitVehicle arayüzü
google.maps.TransitVehicle
arayüz
Toplu taşıma hattında çalışan araçla ilgili bilgiler.
Özellikler | |
|---|---|
icon |
Tür:
stringBu hatta kullanılan araç türüne karşılık gelen bir simgenin URL'si. |
local_icon |
Tür:
stringDaha genel bir simge yerine bu bölgede kullanılan araç türüne karşılık gelen bir simgenin URL'si. |
name |
Tür:
stringBu TransitVehicle türü için bir ad (ör. "Tren" veya "Otobüs"). |
type |
Tür:
VehicleTypeKullanılan aracın türü (ör. tren, otobüs veya vapur). |
VehicleType sabitleri
google.maps.VehicleType
sabitleri
kitaplığı "routes"
Araç türleri için olası değerler.
Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri VehicleTypeString türüyle tanımlanır.
const {VehicleType} = await google.maps.importLibrary("routes");
Sabitler | |
|---|---|
BUS |
Otobüs. |
CABLE_CAR |
Kabloyla, genellikle yerde çalışan bir araç. Teleferikler GONDOLA_LIFT türünde olabilir. |
COMMUTER_TRAIN |
Banliyö treni. |
FERRY |
Feribot. |
FUNICULAR |
Kabloyla dik bir yokuştan yukarı çekilen araç. |
GONDOLA_LIFT |
Teleferik. |
HEAVY_RAIL |
Ağır raylı sistem. |
HIGH_SPEED_TRAIN |
Yüksek hızlı tren. |
INTERCITY_BUS |
Şehirler arası otobüs. |
METRO_RAIL |
Hafif raylı sistem. |
MONORAIL |
Monoray. |
OTHER |
Diğer araçlar. |
RAIL |
Demiryolu. |
SHARE_TAXI |
Dolmuş, güzergahı üzerinde herhangi bir yerde yolcu indirip bindirebilen bir tür otobüs taşımacılığıdır. Dolmuşlarda genellikle minibüs kullanılır. |
SUBWAY |
Yeraltı hafif raylı sistemi. |
TRAM |
Zemin üstü hafif raylı sistem. |
TROLLEYBUS |
Troleybüs. |
UnitSystem sabitleri
google.maps.UnitSystem
sabitleri
kitaplığı "core"
DirectionsRequest içinde belirtilebilecek geçerli birim sistemleri.
const {UnitSystem} = await google.maps.importLibrary("core");
Sabitler | |
|---|---|
IMPERIAL |
DirectionsResult içindeki mesafelerin İngiliz ölçü birimleriyle ifade edilmesi gerektiğini belirtir. |
METRIC |
DirectionsResult içindeki mesafelerin metrik birimlerle ifade edilmesi gerektiğini belirtir. |
Mesafe arayüzü
google.maps.Distance
arayüz
Mesafenin sayısal değer ve görüntüleme dizesi olarak gösterimi.
Özellikler | |
|---|---|
text |
Tür:
stringİstekte belirtilen UnitSystem kullanılarak mesafe değerinin dize gösterimi. |
value |
Tür:
numberMetre cinsinden mesafe. |
Süre
google.maps.Duration
arayüz
Sürenin sayısal değer ve görüntüleme dizesi olarak gösterimi.
Özellikler | |
|---|---|
text |
Tür:
stringSüre değerinin dize gösterimi. |
value |
Tür:
numberSaniye cinsinden süre. |
Zaman arayüzü
google.maps.Time
arayüz
Zamanın Date nesnesi, yerelleştirilmiş dize ve saat dilimi olarak gösterimi.
Özellikler | |
|---|---|
text |
Tür:
stringZaman değerini temsil eden bir dize. Saat, toplu taşıma durağının saat diliminde gösterilir. |
time_zone |
Tür:
stringBu durağın bulunduğu saat dilimi. Değer, IANA Saat Dilimi Veritabanı'nda tanımlandığı şekliyle saat diliminin adıdır (ör. "America/New_York"). |
value |
Tür:
DateBu kalkış veya varış saati, JavaScript Date nesnesi olarak belirtilir. |