- HTTP isteği
- İstek metni
- Yanıt metni
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Rota
- RouteLabel
- RouteLeg
- Çoklu çizgi
- RouteLegStep
- NavigationInstruction
- Manevra
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Görüntü alanı
- RouteLocalizedValues
- PolylineDetails
- TunnelInfo
- RoadFeatureState
- PolylinePointIndex
- RestrictionInfo
- FlyoverInfo
- NarrowRoadInfo
- BridgeInfo
- SkywayInfo
- GeocodingResults
- GeocodedWaypoint
Bir dizi terminal ve ara nokta verildiğinde, isteğe bağlı alternatif rotalarla birlikte birincil rotayı döndürür.
NOT: Bu yöntem, girişte bir yanıt alanı maskesi belirtmenizi gerektirir. Yanıt alanı maskesini $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP/gRPC üstbilgisini kullanarak sağlayabilirsiniz (Kullanılabilir URL parametreleri ve üstbilgileri bölümüne bakın). Değer, alan yollarının virgülle ayrılmış bir listesidir. Alan yollarının nasıl oluşturulacağı ile ilgili ayrıntılı belgelere bakın.
Örneğin, bu yöntemde:
- Kullanılabilir tüm alanların alan maskesi (manuel inceleme için):
X-Goog-FieldMask: * - Rota düzeyinde süre, mesafe ve çoklu çizginin alan maskesi (örnek bir üretim kurulumu):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google, joker karakter (*) yanıt alanı maskesinin kullanılmasını veya alan maskesinin üst düzeyde (routes) belirtilmesini önermez. Bunun nedenleri şunlardır:
- Yalnızca ihtiyacınız olan alanları seçmek, sunucumuzun hesaplama döngülerinden tasarruf etmesine yardımcı olarak sonucu size daha düşük bir gecikmeyle döndürmemizi sağlar.
- Üretim işinizde yalnızca ihtiyacınız olan alanları seçmek, gecikme performansının istikrarlı olmasını sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar için ek hesaplama süresi gerekebilir. Tüm alanları veya üst düzeydeki tüm alanları seçerseniz eklediğimiz yeni alanlar yanıta otomatik olarak dahil edileceğinden performans düşüşü yaşayabilirsiniz.
- Yalnızca ihtiyacınız olan alanları seçtiğinizde yanıt boyutu küçülür ve ağ aktarım hızı artar.
HTTP isteği
POST https://routes.googleapis.com/directions/v2:computeRoutes
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
İstek metni
İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
|---|
{ "origin": { object ( |
| Alanlar | |
|---|---|
origin |
Zorunlu. Başlangıç noktası ara noktası. |
destination |
Zorunlu. Hedef ara nokta. |
intermediates[] |
İsteğe bağlıdır. Rota boyunca durmak veya geçmek için bir dizi yol noktası (terminal noktaları hariç). En fazla 25 ara nokta desteklenir. |
travelMode |
İsteğe bağlıdır. Ulaşım şeklini belirtir. |
routingPreference |
İsteğe bağlıdır. Rotanın nasıl hesaplanacağını belirtir. Sunucu, rotayı hesaplamak için seçilen rota tercihini kullanmaya çalışır. Yönlendirme tercihi bir hataya veya çok uzun bir gecikmeye neden olursa hata döndürülür. Bu seçeneği yalnızca |
polylineQuality |
İsteğe bağlıdır. Çoklu çizginin kalitesiyle ilgili tercihinizi belirtir. |
polylineEncoding |
İsteğe bağlıdır. Çoklu çizgi için tercih edilen kodlamayı belirtir. |
departureTime |
İsteğe bağlıdır. Kalkış saati. Bu değeri ayarlamazsanız varsayılan olarak isteği gönderdiğiniz zaman kullanılır. NOT: Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: |
arrivalTime |
İsteğe bağlıdır. Varış saati. NOT: İstekler Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: |
computeAlternativeRoutes |
İsteğe bağlıdır. Rotaya ek olarak alternatif rotaların hesaplanıp hesaplanmayacağını belirtir. Ara yol noktaları olan istekler için alternatif rota döndürülmez. |
routeModifiers |
İsteğe bağlıdır. Rotaların hesaplanma şeklini etkileyen ve karşılanması gereken bir dizi koşul. |
languageCode |
İsteğe bağlıdır. BCP-47 dil kodu (ör. "en-US" veya "sr-Latn"). Daha fazla bilgi için Unicode Yerel Ayar Tanımlayıcısı başlıklı makaleyi inceleyin. Desteklenen dillerin listesi için Dil Desteği bölümüne bakın. Bu değeri sağlamazsanız görüntüleme dili, rota isteğinin konumundan tahmin edilir. |
regionCode |
İsteğe bağlıdır. ccTLD ("üst düzey alan") iki karakterli değeri olarak belirtilen bölge kodu. Daha fazla bilgi için Ülke kodu üst düzey alanları başlıklı makaleyi inceleyin. |
units |
İsteğe bağlıdır. Görüntüleme alanlarının ölçü birimlerini belirtir. Bu alanlar, |
optimizeWaypointOrder |
İsteğe bağlıdır. Doğru değerine ayarlanırsa hizmet, belirtilen ara noktaları yeniden sıralayarak rotanın toplam maliyetini en aza indirmeye çalışır. Ara yol noktalarından herhangi biri |
requestedReferenceRoutes[] |
İsteğe bağlıdır. Varsayılan rotaya ek olarak, istek kapsamında hangi referans rotaların hesaplanacağını belirtir. Referans rota, varsayılan rotadan farklı bir rota hesaplama hedefine sahip bir rotadır. Örneğin, |
extraComputations[] |
İsteğe bağlıdır. İsteği tamamlamak için kullanılabilecek ek hesaplamaların listesi. Not: Bu ek hesaplamalar, yanıtta ek alanlar döndürebilir. Bu ek alanların, yanıtta döndürülecek alan maskesinde de belirtilmesi gerekir. |
trafficModel |
İsteğe bağlıdır. Trafikte geçen süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, |
transitPreferences |
İsteğe bağlıdır. |
Yanıt metni
v2.computeRoutes yanıt mesajı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
|---|
{ "routes": [ { object ( |
| Alanlar | |
|---|---|
routes[] |
|
fallbackInfo |
Sunucunun tüm giriş tercihleriyle rota sonuçlarını hesaplayamadığı bazı durumlarda, farklı bir hesaplama yöntemi kullanmaya geri dönebilir. Yedek mod kullanıldığında bu alan, yedek yanıtla ilgili ayrıntılı bilgiler içerir. Aksi takdirde bu alanın değeri belirlenmez. |
geocodingResults |
Adres olarak belirtilen ara noktalar için coğrafi kodlama yanıt bilgilerini içerir. |
PolylineQuality
Çoklu çizginin kalitesini belirten bir değerler kümesi.
| Sıralamalar | |
|---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Çoklu çizgi kalitesi tercihi belirtilmedi. Varsayılan değer OVERVIEW'dir. |
HIGH_QUALITY |
Yüksek kaliteli bir çoklu çizgi belirtir. Bu çoklu çizgi, yanıt boyutunun artması pahasına OVERVIEW değerinden daha fazla nokta kullanılarak oluşturulur. Daha fazla hassasiyet gerektiğinde bu değeri kullanın. |
OVERVIEW |
Az sayıda nokta kullanılarak oluşturulan bir genel bakış çoklu çizgisini belirtir. Rotaya genel bakış gösterilirken bu değer kullanılır. Bu seçeneği kullanmak, HIGH_QUALITY seçeneğini kullanmaya kıyasla daha düşük istek gecikmesine sahiptir. |
PolylineEncoding
Döndürülecek çoklu çizginin tercih edilen türünü belirtir.
| Sıralamalar | |
|---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Çoklu çizgi türü tercihi belirtilmedi. Varsayılan değer ENCODED_POLYLINE'dir. |
ENCODED_POLYLINE |
Çoklu çizgi kodlama algoritması kullanılarak kodlanmış bir çoklu çizgiyi belirtir. |
GEO_JSON_LINESTRING |
GeoJSON LineString biçimini kullanarak bir çoklu çizgi belirtir. |
ReferenceRoute
ComputeRoutesRequest'te desteklenen bir referans rota.
| Sıralamalar | |
|---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Kullanılmıyor. Bu değeri içeren istekler başarısız olur. |
FUEL_EFFICIENT |
Yakıt verimliliği yüksek rota. |
SHORTER_DISTANCE |
Seyahat mesafesi daha kısa olan rota. Bu, deneysel bir özelliktir.
Bu özellik, diğer seyahat modları, ara noktalar veya |
ExtraComputation
İstek tamamlanırken gerçekleştirilecek ek hesaplamalar. Gelecekte başka değerler eklenebilir.
| Sıralamalar | |
|---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Kullanılmıyor. Bu değeri içeren istekler başarısız olur. |
TOLLS |
Rotalar için ücret bilgileri. |
FUEL_CONSUMPTION |
Rotalar için tahmini yakıt tüketimi. |
TRAFFIC_ON_POLYLINE |
Rotalar için trafiğe duyarlı çoklu çizgiler. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstruction, biçimlendirilmiş HTML metin dizesi olarak sunulur. Bu içerik olduğu gibi okunmalıdır. Bu içerik yalnızca görüntüleme amaçlıdır. Programatik olarak ayrıştırmayın. |
FLYOVER_INFO_ON_POLYLINE |
Rotalar için üst geçit bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.flyover_info alan maskesi belirtilmelidir. Bu veriler şu anda yalnızca Hindistan'daki belirli metropoller için doldurulur. Bu özellik deneme aşamasındadır ve SKU/ücret değişebilir. |
NARROW_ROAD_INFO_ON_POLYLINE |
Rotalar için dar yol bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.narrow_road_info alan maskesi belirtilmelidir. Bu veriler şu anda yalnızca Hindistan'daki belirli metropoller için doldurulur. Bu özellik deneme aşamasındadır ve SKU/ücret değişebilir. |
TUNNEL_INFO_ON_POLYLINE |
Rotalar için tünel bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.tunnel_info alan maskesi belirtilmelidir. |
BRIDGE_INFO_ON_POLYLINE |
Rotalar için köprü bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.bridge_info alan maskesi belirtilmelidir. |
SKYWAY_INFO_ON_POLYLINE |
Rotalar için üst geçit bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.skyway_info alan maskesi belirtilmelidir. |
Rota
Başlangıç, bitiş ve ara noktaları birleştiren bir dizi bağlı yol segmentinden oluşan bir rota içerir.
| JSON gösterimi |
|---|
{ "routeLabels": [ enum ( |
| Alanlar | |
|---|---|
routeLabels[] |
|
legs[] |
Rotayı oluşturan ayakların (ara noktalar arasındaki yol segmentleri) koleksiyonu. Her ayak, |
distanceMeters |
Rotanın metre cinsinden seyahat mesafesi. |
duration |
Rotada gezinmek için gereken süre.
Diğer tüm durumlarda, En fazla dokuz kesirli basamak içeren ve " |
staticDuration |
Trafik koşulları dikkate alınmadan rota boyunca seyahat süresi. En fazla dokuz kesirli basamak içeren ve " |
polyline |
Genel rota çoklu çizgisi. Bu çoklu çizgi, tüm |
description |
Rotanın açıklaması. |
warnings[] |
Rota gösterilirken gösterilecek uyarıların dizisi. |
viewport |
Çoklu çizginin görüntü alanı sınırlayıcı kutusu. |
travelAdvisory |
Rota hakkında ek bilgiler. |
optimizedIntermediateWaypointIndex[] |
|
localizedValues |
|
routeToken |
Navigasyon sırasında rotayı yeniden oluşturmak ve yeni rota çizilmesi durumunda rota oluşturulurkenki asıl niyeti dikkate almak için Navigation SDK'ya iletilebilen opak bir jeton. Bu jetonu opak bir blob olarak değerlendirin. Hizmet tam olarak aynı rotayı döndürse bile değeri değişebileceğinden, değerini istekler arasında karşılaştırmayın. NOT: |
polylineDetails |
Çoklu çizgi boyunca ayrıntılarla ilgili bilgiler içerir. |
RouteLabel
için, rotanın belirli özelliklerini diğerleriyle karşılaştırmak üzere tanımlamak için yararlı olan etiketler.Route
| Sıralamalar | |
|---|---|
ROUTE_LABEL_UNSPECIFIED |
Varsayılan - kullanılmaz. |
DEFAULT_ROUTE |
Rota hesaplaması için döndürülen varsayılan "en iyi" rota. |
DEFAULT_ROUTE_ALTERNATE |
Varsayılan "en iyi" rotaya alternatif. belirtildiğinde bu tür rotalar döndürülür. |
FUEL_EFFICIENT |
Yakıt verimliliği yüksek rota. Bu değerle etiketlenen rotaların, yakıt tüketimi gibi Eko parametreleri için optimize edildiği belirlenmiştir. |
SHORTER_DISTANCE |
Daha kısa seyahat mesafesi rotası. Bu, deneysel bir özelliktir. |
RouteLeg
via olmayan ara noktalar arasında bir segment içeriyor.
| JSON gösterimi |
|---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
| Alanlar | |
|---|---|
distanceMeters |
Rota ayağının metre cinsinden seyahat mesafesi. |
duration |
Bacakta gezinmek için gereken süre.
Diğer tüm durumlarda, En fazla dokuz kesirli basamak içeren ve " |
staticDuration |
Trafik koşulları dikkate alınmadan hesaplanan, etap boyunca seyahat süresi. En fazla dokuz kesirli basamak içeren ve " |
polyline |
Bu ayağın her bir |
startLocation |
Bu ayağın başlangıç konumu. Bu konum, sağlanan |
endLocation |
Bu ayağın bitiş konumu. Bu konum, sağlanan |
steps[] |
Bu ayaktaki segmentleri gösteren bir adım dizisi. Her adım bir navigasyon talimatını temsil eder. |
travelAdvisory |
Kullanıcının rota ayağında bilgilendirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir. |
localizedValues |
|
stepsOverview |
Bu |
Çoklu çizgi
Kodlanmış bir çoklu çizgiyi kapsar.
| JSON gösterimi |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "encodedPolyline": string, "geoJsonLinestring": { object } // End of mutually exclusive fields. } |
| Alanlar | |
|---|---|
| Çoklu çizginin türünü kapsar. Varsayılan olarak encoded_polyline değerine ayarlanır. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır: | |
encodedPolyline |
Çoklu çizgi kodlama algoritması kullanılarak çoklu çizginin dize kodlaması |
geoJsonLinestring |
GeoJSON LineString biçimini kullanarak bir çoklu çizgi belirtir. |
| Birbirini hariç tutan alanların sonu. | |
RouteLegStep
segmenti içerir. Bir adım, tek bir navigasyon talimatına karşılık gelir. Rota ayakları adımlardan oluşur.RouteLeg
| JSON gösterimi |
|---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
| Alanlar | |
|---|---|
distanceMeters |
Bu adımın metre cinsinden seyahat mesafesi. Bazı durumlarda bu alanın değeri olmayabilir. |
staticDuration |
Trafik koşulları dikkate alınmadan bu adımda seyahat süresi. Bazı durumlarda bu alanın değeri olmayabilir. En fazla dokuz kesirli basamak içeren ve " |
polyline |
Bu adımla ilişkili çoklu çizgi. |
startLocation |
Bu adımın başlangıç konumu. |
endLocation |
Bu adımın bitiş konumu. |
navigationInstruction |
Navigasyon talimatları. |
travelAdvisory |
Kullanıcının bir bacak adımında bilgilendirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir. |
localizedValues |
|
transitDetails |
Seyahat modu |
travelMode |
Bu adım için kullanılan seyahat modu. |
Manevra
Mevcut adım için gerçekleştirilecek navigasyon işlemini (ör. sola dön, birleş veya düz git) belirten bir değerler kümesi.
| Sıralamalar | |
|---|---|
MANEUVER_UNSPECIFIED |
Kullanılmıyor. |
TURN_SLIGHT_LEFT |
Hafifçe sola dönün. |
TURN_SHARP_LEFT |
Sola keskin dönüş yapın. |
UTURN_LEFT |
Sola U dönüşü yapın. |
TURN_LEFT |
Sola dönün. |
TURN_SLIGHT_RIGHT |
Hafifçe sağa dönün. |
TURN_SHARP_RIGHT |
Sağa keskin dönüş yapın. |
UTURN_RIGHT |
Sağa U dönüşü yapın. |
TURN_RIGHT |
Sağa dönün. |
STRAIGHT |
Düz gidin. |
RAMP_LEFT |
Soldaki rampaya girin. |
RAMP_RIGHT |
Sağdaki rampaya girin. |
MERGE |
Trafiğe katılın. |
FORK_LEFT |
Soldaki yola girin. |
FORK_RIGHT |
Sağdaki yola girin. |
FERRY |
Feribota binin. |
FERRY_TRAIN |
Feribota giden trene binin. |
ROUNDABOUT_LEFT |
Döner kavşaktan sola dönün. |
ROUNDABOUT_RIGHT |
Döner kavşaktan sağa dönün. |
DEPART |
İlk manevra. |
NAME_CHANGE |
Sokak adı değişikliğini belirtmek için kullanılır. |
DESTINATION |
Hedefe varıldığını belirtmek için kullanılır. |
RouteLegStepTravelAdvisory
Kullanıcının bilgilendirilmesi gereken ek bilgileri (ör. bir bacak adımındaki olası trafik bölgesi kısıtlamaları) içerir.
| JSON gösterimi |
|---|
{
"speedReadingIntervals": [
{
object ( |
| Alanlar | |
|---|---|
speedReadingIntervals[] |
NOT: Bu alan şu anda doldurulmamıştır. |
RouteLegStepLocalizedValues
Belirli özelliklerin metin temsilleri.
| JSON gösterimi |
|---|
{ "distance": { object ( |
| Alanlar | |
|---|---|
distance |
Metin biçiminde gösterilen seyahat mesafesi. |
staticDuration |
Trafik koşulları dikkate alınmadan hesaplanan sürenin metin biçiminde gösterimi. |
RouteLegStepTransitDetails
TRANSIT rotalarıyla ilgili RouteLegStep için ek bilgiler.
| JSON gösterimi |
|---|
{ "stopDetails": { object ( |
| Alanlar | |
|---|---|
stopDetails |
Adımın varış ve kalkış durakları hakkında bilgi. |
localizedValues |
|
headsign |
Araçta veya kalkış durağında işaretlendiği şekilde bu hatta seyahat edilecek yönü belirtir. Yön genellikle son istasyondur. |
headway |
Beklenen süreyi, bu saatte aynı duraktan kalkışlar arasındaki süre olarak belirtir. Örneğin, 600 saniyelik bir sefer sıklığı değeriyle, otobüsünüzü kaçırırsanız on dakika beklemeniz gerekir. En fazla dokuz kesirli basamak içeren ve " |
transitLine |
Bu adımda kullanılan toplu taşıma hattı hakkında bilgi. |
stopCount |
Kalkış durağından varış durağına kadar olan durak sayısı. Bu sayıya varış durağı dahildir ancak kalkış durağı dahil değildir. Örneğin, rotanız A durağından başlayıp B ve C duraklarından geçerek D durağına ulaşıyorsa |
tripShortText |
Yolculara toplu taşıma yolculuğunu tanımlamak için programlarda ve tabelalarda görünen metin. Metin, bir hizmet günü içindeki bir geziyi benzersiz şekilde tanımlamalıdır. Örneğin, "538", hafta içi günlerde saat 15:10'da San Jose, Kaliforniya'dan Sacramento, Kaliforniya'ya giden Amtrak treninin |
TransitStopDetails
RouteLegStep için toplu taşıma duraklarıyla ilgili ayrıntılar.
| JSON gösterimi |
|---|
{ "arrivalStop": { object ( |
| Alanlar | |
|---|---|
arrivalStop |
Adım için varış durağıyla ilgili bilgiler. |
arrivalTime |
Adım için tahmini varış zamanı. Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: |
departureStop |
Adım için kalkış durağı hakkında bilgi. |
departureTime |
Adımın tahmini kalkış zamanı. Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: |
TransitStop
Toplu taşıma durağıyla ilgili bilgiler.
| JSON gösterimi |
|---|
{
"name": string,
"location": {
object ( |
| Alanlar | |
|---|---|
name |
Toplu taşıma durağının adı. |
location |
Durağın enlem/boylam koordinatlarıyla ifade edilen konumu. |
TransitDetailsLocalizedValues
RouteTransitDetails için değerlerin yerelleştirilmiş açıklamaları.
| JSON gösterimi |
|---|
{ "arrivalTime": { object ( |
| Alanlar | |
|---|---|
arrivalTime |
İlgili saat dilimiyle birlikte biçimlendirilmiş metin gösterimindeki saat. |
departureTime |
İlgili saat dilimiyle birlikte biçimlendirilmiş metin gösterimindeki saat. |
LocalizedTime
Zamanın yerelleştirilmiş açıklaması.
| JSON gösterimi |
|---|
{
"time": {
object ( |
| Alanlar | |
|---|---|
time |
Belirli bir saat diliminde dize olarak belirtilen saat. |
timeZone |
Saat dilimini içerir. Değer, IANA Saat Dilimi Veritabanı'nda tanımlandığı şekilde saat diliminin adıdır (ör. "America/New_York"). |
TransitLine
Bu adımda kullanılan toplu taşıma hattı hakkında bilgi içerir.
| JSON gösterimi |
|---|
{ "agencies": [ { object ( |
| Alanlar | |
|---|---|
agencies[] |
Bu toplu taşıma hattını işleten toplu taşıma kuruluşu (veya kuruluşları). |
name |
Bu toplu taşıma hattının tam adı. Örneğin, "8 Avenue Local". |
uri |
Transit operatörü tarafından sağlanan bu toplu taşıma hattının URI'si. |
color |
Bu hat için tabelalarda yaygın olarak kullanılan renk. Onaltılık olarak temsil edilir. |
iconUri |
Bu satırla ilişkili simgenin URI'si. |
nameShort |
Bu toplu taşıma hattının kısa adı. Bu ad genellikle "M7" veya "355" gibi bir hat numarasıdır. |
textColor |
Bu hattın tabelalarındaki metinlerde yaygın olarak kullanılan renk. Onaltılık olarak temsil edilir. |
vehicle |
Bu toplu taşıma hattında çalışan araç türü. |
TransitAgency
Toplu taşıma hattını işleten transit operatörü.
| JSON gösterimi |
|---|
{ "name": string, "phoneNumber": string, "uri": string } |
| Alanlar | |
|---|---|
name |
Bu transit operatörünün adı. |
phoneNumber |
Transit operatörünün uluslararası standarttaki telefon numarası. |
uri |
Toplu taşıma şirketinin URI'si. |
TransitVehicle
Toplu taşıma rotalarında kullanılan araçlarla ilgili bilgiler.
| JSON gösterimi |
|---|
{ "name": { object ( |
| Alanlar | |
|---|---|
name |
Bu aracın adı (büyük harfle yazılır). |
type |
Kullanılan aracın türü. |
iconUri |
Bu araç türüyle ilişkili bir simgenin URI'si. |
localIconUri |
Yerel ulaşım tabelalarına göre bu araç türüyle ilişkili simgenin URI'si. |
TransitVehicleType
Toplu taşıma rotaları için araç türü.
| Sıralamalar | |
|---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
Kullanılmıyor. |
BUS |
Otobüs. |
CABLE_CAR |
Kabloyla çalışan, genellikle yerde bulunan bir araç. Teleferikler GONDOLA_LIFT türünde olabilir. |
COMMUTER_TRAIN |
Banliyö treni. |
FERRY |
Feribot. |
FUNICULAR |
Kabloyla dik bir yokuştan yukarı çekilen araç. Füniküler genellikle iki vagondan oluşur ve her vagon diğeri için karşı ağırlık görevi görür. |
GONDOLA_LIFT |
Teleferik. |
HEAVY_RAIL |
Ağır raylı sistem. |
HIGH_SPEED_TRAIN |
Yüksek hızlı tren. |
INTERCITY_BUS |
Şehirler arası otobüs. |
LONG_DISTANCE_TRAIN |
Şehirler arası tren. |
METRO_RAIL |
Hafif raylı sistem. |
MONORAIL |
Monoray. |
OTHER |
Diğer tüm araçlar. |
RAIL |
Demiryolu. |
SHARE_TAXI |
Dolmuş, güzergahı üzerinde herhangi bir yerde yolcu indirip bindirebilen bir tür otobüstür. |
SUBWAY |
Yeraltı hafif raylı sistemi. |
TRAM |
Zemin üstü hafif raylı sistem. |
TROLLEYBUS |
Troleybüs. |
RouteLegTravelAdvisory
Kullanıcının bir bacak adımında bilgilendirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir.
| JSON gösterimi |
|---|
{ "tollInfo": { object ( |
| Alanlar | |
|---|---|
tollInfo |
Belirli bir |
speedReadingIntervals[] |
Trafik yoğunluğunu gösteren hız ölçüm aralıkları. Bu alan, yalnızca istekte Örnek: |
RouteLegLocalizedValues
Belirli özelliklerin metin temsilleri.
| JSON gösterimi |
|---|
{ "distance": { object ( |
| Alanlar | |
|---|---|
distance |
Metin biçiminde gösterilen seyahat mesafesi. |
duration |
Süre, metin biçiminde gösterilir ve sorgunun bölgesine göre yerelleştirilir. Trafik koşullarını dikkate alır. Not: Trafik bilgisi istemediyseniz bu değer, staticDuration ile aynıdır. |
staticDuration |
Trafik koşulları dikkate alınmadan hesaplanan sürenin metin biçiminde gösterimi. |
StepsOverview
RouteLegStep listesi hakkında genel bilgiler sağlar.
| JSON gösterimi |
|---|
{
"multiModalSegments": [
{
object ( |
| Alanlar | |
|---|---|
multiModalSegments[] |
|
MultiModalSegment
RouteLeg.steps adlı videonun farklı çok formatlı segmentleri hakkında özet bilgi sağlar. Çok modlu segment, aynı RouteTravelMode değerine sahip bir veya daha fazla bitişik RouteLegStep olarak tanımlanır. RouteLeg, adımlarda çok formatlı segmentler içermiyorsa bu alan doldurulmaz.
| JSON gösterimi |
|---|
{ "navigationInstruction": { object ( |
| Alanlar | |
|---|---|
navigationInstruction |
Çok formatlı segment için NavigationInstruction. |
travelMode |
Çok formatlı segmentin seyahat modu. |
stepStartIndex |
Çok formatlı segmentin başlangıcı olan ilgili |
stepEndIndex |
Çok formatlı segmentin sonu olan ilgili |
Görüntü alanı
Çapraz olarak karşılıklı iki low ve high noktası olarak temsil edilen bir enlem-boylam görüntü alanı. Görüntü alanı kapalı bir bölge olarak kabul edilir. Yani sınırını içerir. Enlem sınırları -90 ile 90 derece arasında (bu değerler dahil), boylam sınırları ise -180 ile 180 derece arasında (bu değerler dahil) olmalıdır. Çeşitli durumlar şunlardır:
low=highise görüntü alanı bu tek noktadan oluşur.low.longitude>high.longitudeise boylam aralığı ters çevrilir (görüntü alanı 180 derece boylam çizgisini geçer).low.longitude= -180 derece vehigh.longitude= 180 derece ise görüntü alanı tüm boylamları içerir.low.longitude= 180 derece vehigh.longitude= -180 derece ise boylam aralığı boştur.low.latitude>high.latitudeise enlem aralığı boştur.
Hem low hem de high doldurulmalıdır ve temsil edilen kutu boş olamaz (yukarıdaki tanımlarda belirtildiği gibi). Görüntü alanının boş olması hataya neden olur.
Örneğin, bu görüntü alanı New York'u tamamen kapsar:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
| JSON gösterimi |
|---|
{ "low": { object ( |
| Alanlar | |
|---|---|
low |
Zorunlu. Görüntü alanının alt noktası. |
high |
Zorunlu. Görüntü alanının en yüksek noktası. |
RouteLocalizedValues
Belirli özelliklerin metin temsilleri.
| JSON gösterimi |
|---|
{ "distance": { object ( |
| Alanlar | |
|---|---|
distance |
Metin biçiminde gösterilen seyahat mesafesi. |
duration |
Süre, metin biçiminde gösterilir ve sorgunun bölgesine göre yerelleştirilir. Trafik koşullarını dikkate alır. Not: Trafik bilgisi istemediyseniz bu değer, |
staticDuration |
Trafik koşulları dikkate alınmadan hesaplanan sürenin metin biçiminde gösterimi. |
transitFare |
Metin biçiminde gösterilen toplu taşıma ücreti. |
PolylineDetails
Belirli bir dizine veya çoklu çizginin bitişik segmentine karşılık gelen ayrıntılar. P_0, P_1, ... , P_N (sıfır tabanlı dizin) noktalarına sahip bir çoklu çizgi verildiğinde PolylineDetails, bir aralığı ve ilişkili meta verileri tanımlar.
| JSON gösterimi |
|---|
{ "tunnelInfo": [ { object ( |
| Alanlar | |
|---|---|
tunnelInfo[] |
Çoklu çizgi boyunca tünel ayrıntıları. İstekte |
restrictionInfo[] |
Çoklu çizgi boyunca kısıtlama ayrıntıları. Bu alan yalnızca bir istekte |
flyoverInfo[] |
Çoklu çizgi boyunca kuşbakışı görünüm ayrıntıları. |
narrowRoadInfo[] |
Çoklu çizgi boyunca dar yol ayrıntıları. |
bridgeInfo[] |
Çoklu çizgi boyunca köprü ayrıntıları. |
skywayInfo[] |
Çoklu çizgi boyunca Skyway ayrıntıları. |
TunnelInfo
Çoklu çizgi boyunca tünellerle ilgili bilgileri kapsar.
| JSON gösterimi |
|---|
{ "tunnelPresence": enum ( |
| Alanlar | |
|---|---|
tunnelPresence |
Çoklu çizginin belirli bir bölümü için tünel olup olmadığını belirtir. |
polylinePointIndex |
Çoklu çizgi boyunca tünelle ilgili bilgilerin konumu. |
RoadFeatureState
Bir çoklu çizgi boyunca yol özelliklerinin durumlarını kapsar.
| Sıralamalar | |
|---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
Yol özelliğinin durumu hesaplanmadı (varsayılan değer). |
EXISTS |
Yol özelliği mevcut. |
DOES_NOT_EXIST |
Yol özelliği mevcut değil. |
PolylinePointIndex
Çoklu çizgi ayrıntısının başlangıç ve bitiş dizinlerini kapsar. Verilerin tek bir noktaya karşılık geldiği durumlarda startIndex ve endIndex eşit olur.
| JSON gösterimi |
|---|
{ "startIndex": integer, "endIndex": integer } |
| Alanlar | |
|---|---|
startIndex |
Çoklu çizgideki bu ayrıntının başlangıç dizini. |
endIndex |
Bu ayrıntının çoklu çizgideki bitiş dizini. |
RestrictionInfo
Çoklu çizgi boyunca çeşitli kısıtlamalarla ilgili bilgileri kapsar.
| JSON gösterimi |
|---|
{ "restrictionPresence": enum ( |
| Alanlar | |
|---|---|
restrictionPresence |
Yalnızca çıkış. Çoklu çizginin belirli bir bölümü için kısıtlama olup olmadığını belirtir. |
polylinePointIndex |
Çoklu çizgi boyunca kısıtlamayla ilgili bilgilerin konumu. |
| Çoklu çizginin belirli bir bölümü için geçerli olabilecek kısıtlama türlerini kapsar. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır: | |
restrictedHeightMm |
Milimetre cinsinden yükseklik sınırı. Bu alan, kısıtlanmış yükseklik geçişi engellediğinde veya belirtilen araç için düşük açıklıkla sonuçlandığında doldurulur. |
restrictedWeightKg |
Kilogram cinsinden ağırlık sınırı. Bu alan, ağırlık kısıtlaması geçişi engellediğinde veya belirtilen aracın ağırlığına yakın olduğunda doldurulur. |
hazardousGoods |
Tehlikeli madde taşımak kısıtlandığında bu alan "true" olarak ayarlanır. |
trucksProhibited |
Kamyonların yasak olduğu durumlarda bu alan "true" olarak ayarlanır. |
| Birbirini hariç tutan alanların sonu. | |
FlyoverInfo
Çoklu çizgi boyunca üst geçitlerle ilgili bilgileri kapsar.
| JSON gösterimi |
|---|
{ "flyoverPresence": enum ( |
| Alanlar | |
|---|---|
flyoverPresence |
Yalnızca çıkış. Çoklu çizginin belirli bir bölümü için üst geçit olup olmadığını belirtir. |
polylinePointIndex |
Çoklu çizgi boyunca üst geçitle ilgili bilgilerin konumu. |
NarrowRoadInfo
Çoklu çizgi boyunca dar yollarla ilgili bilgileri kapsar.
| JSON gösterimi |
|---|
{ "narrowRoadPresence": enum ( |
| Alanlar | |
|---|---|
narrowRoadPresence |
Yalnızca çıkış. Çoklu çizginin belirli bir bölümünde dar bir yol olup olmadığını belirtir. |
polylinePointIndex |
Çoklu çizgi boyunca dar yolla ilgili bilgilerin konumu. |
BridgeInfo
Çoklu çizgi boyunca köprülerle ilgili bilgileri kapsar.
| JSON gösterimi |
|---|
{ "bridgePresence": enum ( |
| Alanlar | |
|---|---|
bridgePresence |
Çoklu çizginin belirli bir bölümünde köprü olup olmadığını belirtir. |
polylinePointIndex |
Çoklu çizgi boyunca köprüyle ilgili bilgilerin konumu. |
SkywayInfo
Çoklu çizgi boyunca üst geçitlerle ilgili bilgileri kapsar.
| JSON gösterimi |
|---|
{ "skywayPresence": enum ( |
| Alanlar | |
|---|---|
skywayPresence |
Çoklu çizginin belirli bir bölümü için bir üst geçit olup olmadığını belirtir. |
polylinePointIndex |
Çoklu çizgi boyunca geçit ile ilgili bilgilerin konumu. |
GeocodingResults
Başlangıç noktası, varış noktası ve ara noktalar için içerir. Yalnızca adres noktaları için doldurulur.GeocodedWaypoints
| JSON gösterimi |
|---|
{ "origin": { object ( |
| Alanlar | |
|---|---|
origin |
Coğrafi olarak kodlanmış başlangıç noktası. |
destination |
Hedefin coğrafi kodlu yol noktası. |
intermediates[] |
Her biri, istekte belirtildikleri sırayla ara noktanın sıfır tabanlı konumuna karşılık gelen bir dizin alanı içeren, coğrafi kodlu ara noktaların listesi. |
GeocodedWaypoint
Ara nokta olarak kullanılan konumlarla ilgili ayrıntılar. Yalnızca adres noktaları için doldurulur. Adresin hangi coğrafi koda dönüştürüldüğünü belirlemek amacıyla coğrafi kodlama sonuçlarıyla ilgili ayrıntıları içerir.
| JSON gösterimi |
|---|
{
"geocoderStatus": {
object ( |
| Alanlar | |
|---|---|
geocoderStatus |
Coğrafi kodlama işleminden kaynaklanan durum kodunu gösterir. |
type[] |
Sıfır veya daha fazla tür etiketi biçiminde sonucun türleri. Desteklenen türler: Adres türleri ve adres bileşeni türleri. |
partialMatch |
Coğrafi kodlayıcının, istenen adresin bir kısmını eşleştirebilmesine rağmen orijinal istek için tam eşleşme döndürmediğini gösterir. Orijinal istekte yazım hataları ve/veya eksik adres olup olmadığını inceleyebilirsiniz. |
placeId |
Bu sonucun yer kimliği. |
intermediateWaypointRequestIndex |
İstekteki ilgili ara yol noktasının dizini. Yalnızca ilgili ara nokta bir ara noktaysa doldurulur. |