- 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ünüm 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öntemde, girişte bir yanıt alan maskesi belirtmeniz gerekir. Yanıt alan maskesini $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP/gRPC üst bilgisini kullanarak sağlayabilirsiniz (kullanılabilir URL parametreleri ve üst bilgileri bölümüne bakın). Değer, virgülle ayrılmış alan yolu listesidir. Alan yollarının nasıl oluşturulacağı hakkında ayrıntılı belgelere bakın.
Örneğin, bu yöntemde:
- Mevcut tüm alanların alan maskesi (manuel inceleme için):
X-Goog-FieldMask: * - Rota düzeyinde süre, mesafe ve çoklu çizgi alan maskesi (üretim kurulumu örneği):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google, joker karakter (*) yanıt alanı maskesinin kullanılmasını veya alan maskesinin en üst düzeyde (routes) belirtilmesini şu nedenlerle önermez:
- Yalnızca ihtiyacınız olan alanları seçmek, sunucumuzun hesaplama döngülerini kaydetmesine yardımcı olur. Bu sayede, sonucu size daha düşük gecikmeyle döndürebiliriz.
- Üretim işinizde yalnızca ihtiyacınız olan alanları seçmek, gecikme süresinin kararlı bir şekilde performans göstermesini sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar ek hesaplama süresi gerektirebilir. Tüm alanları veya en üst düzeydeki tüm alanları seçerseniz eklediğimiz her yeni alan yanıta otomatik olarak dahil edileceğinden performans düşüşü yaşayabilirsiniz.
- Yalnızca ihtiyacınız olan alanları seçmek daha küçük bir yanıt boyutu ve dolayısıyla daha yüksek bir ağ işleme hızı sağlar.
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ıç ara noktası. |
destination |
Zorunlu. Hedef ara nokta. |
intermediates[] |
İsteğe bağlı. Rotadaki bir dizi ara nokta (terminal noktaları hariç) durmak veya geçmek için. En fazla 25 ara nokta desteklenir. |
travelMode |
İsteğe bağlı. Ulaşım şeklini belirtir. |
routingPreference |
İsteğe bağlı. Rotanın nasıl hesaplanacağını belirtir. Sunucu, rotayı hesaplamak için seçilen yönlendirme tercihini kullanmaya çalışır. Yönlendirme tercihi bir hataya veya aşırı uzun bir gecikmeye neden olursa hata döndürülür. Bu seçeneği yalnızca |
polylineQuality |
İsteğe bağlı. Çoklu çizginin kalitesiyle ilgili tercihinizi belirtir. |
polylineEncoding |
İsteğe bağlı. Çoklu çizgi için tercih edilen kodlamayı belirtir. |
departureTime |
İsteğe bağlı. Kalkış saati. Bu değeri ayarlamazsanız varsayılan olarak isteği gönderdiğiniz zaman kullanılır. NOT: Yalnızca 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ı. Varış saati NOT: İsteklerde 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ı. Rotaya ek olarak alternatif rotaların da hesaplanıp hesaplanmayacağını belirtir. Ara yol noktaları olan istekler için alternatif rotalar döndürülmez. |
routeModifiers |
İsteğe bağlı. Rotaların hesaplanma şeklini etkileyen bir dizi koşul. |
languageCode |
İsteğe bağlı. BCP-47 dil kodu (ör. "en-US" veya "sr-Latn"). Daha fazla bilgi için Unicode Yerel Kimliği başlıklı makaleyi inceleyin. Desteklenen dillerin listesi için Dil Desteği bölümüne bakın. Bu değeri sağlamadığınızda, rota isteğinin konumundan ekran dili çıkarılır. |
regionCode |
İsteğe bağlı. Bölge kodu, ccTLD ("üst düzey alan") olarak belirtilen iki karakterli bir değerdir. Daha fazla bilgi için Ülke kodu üst düzey alanları başlıklı makaleyi inceleyin. |
units |
İsteğe bağlı. Görüntüleme alanlarının ölçü birimlerini belirtir. Bu alanlar, |
optimizeWaypointOrder |
İsteğe bağlı. Doğru olarak ayarlanırsa hizmet, belirtilen ara yol noktalarını yeniden sıralayarak rotanın genel maliyetini en aza indirmeye çalışır. Ara yol noktalarından herhangi biri |
requestedReferenceRoutes[] |
İsteğe bağlı. 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 olan rotadır. Örneğin, |
extraComputations[] |
İsteğe bağlı. İ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ülmek üzere alan maskesinde de belirtilmesi gerekir. |
trafficModel |
İsteğe bağlı. Trafikte geçen süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, |
transitPreferences |
İsteğe bağlı. |
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 |
Bazı durumlarda, sunucu rota sonuçlarını tüm giriş tercihlerine göre hesaplayamadığında farklı bir hesaplama yöntemi kullanabilir. Yedek mod kullanıldığında bu alan, yedek yanıtla ilgili ayrıntılı bilgileri 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 grubu.
| Sıralamalar | |
|---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Çoklu çizgi kalitesi tercihi belirtilmedi. Varsayılan olarak OVERVIEW değerine ayarlanır. |
HIGH_QUALITY |
Yanıt boyutunun artması pahasına, OVERVIEW değerinden daha fazla nokta kullanılarak oluşturulan yüksek kaliteli bir çoklu çizgi belirtir. Daha fazla hassasiyete ihtiyacınız olduğunda bu değeri kullanın. |
OVERVIEW |
Az sayıda nokta kullanılarak oluşturulan bir genel bakış polilineğini belirtir. Rotanın genel görünümünü gösterirken bu değeri kullanın. Bu seçeneği kullanmak, HIGH_QUALITY seçeneğini kullanmaya kıyasla daha düşük istek gecikmesine sahiptir. |
PolylineEncoding
Döndürülecek tercih edilen çoklu çizgi türünü belirtir.
| Sıralamalar | |
|---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Çoklu çizgi türü tercihi belirtilmedi. Varsayılan olarak ENCODED_POLYLINE değerine ayarlanır. |
ENCODED_POLYLINE |
Çoklu çizgi kodlama algoritması kullanılarak kodlanmış bir çoklu çizgi belirtir. |
GEO_JSON_LINESTRING |
GeoJSON LineString biçimini kullanarak bir çoklu çizgi belirtir. |
ReferenceRoute
ComputeRoutesRequest üzerinde 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 |
Daha kısa seyahat mesafesine sahip rota. Bu, deneysel bir özelliktir. Bu özellik,
Bu özellik, ara yol noktaları veya |
ExtraComputation
İsteği tamamlarken 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ın tahmini yakıt tüketimi. |
TRAFFIC_ON_POLYLINE |
Rotalar için trafiğe duyarlı çoklu çizgiler. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstruction biçimlendirilmiş bir 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 kuşbakışı görünüm bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.flyover_info fieldmask'ı belirtilmelidir. Bu veriler şu anda yalnızca Hindistan'daki belirli metropoller için doldurulmaktadır. Bu özellik deneyseldir ve SKU/ücret değişebilir. |
NARROW_ROAD_INFO_ON_POLYLINE |
Rota(lar) için dar yol bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.narrow_road_info fieldmask'ı belirtilmelidir. Bu veriler şu anda yalnızca Hindistan'daki belirli metropoller için doldurulmaktadır. Bu özellik deneyseldir ve SKU/ücret değişebilir. |
TUNNEL_INFO_ON_POLYLINE |
Rotalarla ilgili tünel bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.tunnel_info fieldmask'ı belirtilmelidir. |
BRIDGE_INFO_ON_POLYLINE |
Güzergahlar için köprü bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.bridge_info fieldmask'ı belirtilmelidir. |
SKYWAY_INFO_ON_POLYLINE |
Rotalar için Skyway bilgileri. Bu bilgilerin döndürülmesi için routes.polyline_details.skyway_info fieldmask'ı 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[] |
Rotanın belirli özelliklerini tanımlamak ve diğerleriyle karşılaştırmak için yararlı olan |
legs[] |
Rotayı oluşturan ayakların (ara noktalar arasındaki yol segmentleri) bir koleksiyonu. Her aşama, iki |
distanceMeters |
Rotanın seyahat mesafesi (metre cinsinden). |
duration |
Rotada ilerlemek için gereken süre. En fazla dokuz kesirli basamak içeren ve " |
staticDuration |
Trafik koşulları dikkate alınmadan rotada seyahat süresi. En fazla dokuz kesirli basamak içeren ve " |
polyline |
Rotanın genel çoklu çizgisi. Bu çoklu çizgi, tüm |
description |
Rotanın açıklaması. |
warnings[] |
Rota gösterilirken gösterilecek uyarı dizisi. |
viewport |
Çoklu çizginin görüntü alanı sınırlayıcı kutusu. |
travelAdvisory |
Rota hakkında ek bilgiler. |
optimizedIntermediateWaypointIndex[] |
|
localizedValues |
|
routeToken |
Rotayı izleme sırasında rotayı yeniden oluşturmak için Navigation SDK'ya iletilebilen ve yeniden yönlendirme durumunda rota oluşturulurken amaçlanan orijinal rotayı kullanan 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 üzerindeki ayrıntılarla ilgili bilgileri içerir. |
RouteLabel
Rotanın belirli özelliklerini tanımlamak ve diğerleriyle karşılaştırmak için yararlı olan etiketleri.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 çevre dostu parametreler için optimize edildiği belirlenir. |
SHORTER_DISTANCE |
Daha kısa seyahat mesafesi rotası. Bu, deneysel bir özelliktir. |
RouteLeg
via olmayan ara noktalar arasında bir segment içerir.
| JSON gösterimi |
|---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
| Alanlar | |
|---|---|
distanceMeters |
Rota ayağının metre cinsinden seyahat mesafesi. |
duration |
Ayağın tamamlanması için gereken süre. En fazla dokuz kesirli basamak içeren ve " |
staticDuration |
Trafik koşulları dikkate alınmadan hesaplanan, etaptaki seyahat süresi. En fazla dokuz kesirli basamak içeren ve " |
polyline |
Bu ayağın genel çoklu çizgisi, her |
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 dizi adım. Her adım bir gezinme talimatını temsil eder. |
travelAdvisory |
Kullanıcının bilgilendirilmesi gereken ek bilgileri (ör. bir rota ayağında 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 çizgi türünü kapsar. Varsayılan olarak encoded_polyline değerine ayarlanır. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde 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. |
| Karşılıklı olarak hariç tutulan 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 yapılan seyahatin 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 |
Gezinme talimatları. |
travelAdvisory |
Kullanıcının bir ayak 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 ulaşım şekli. |
Manevra
Mevcut adım için gerçekleştirilecek gezinme işlemini belirten bir değer grubu (örneğin, sola dön, birleş veya düz git).
| Sıralamalar | |
|---|---|
MANEUVER_UNSPECIFIED |
Kullanılmıyor. |
TURN_SLIGHT_LEFT |
Hafifçe sola dönün. |
TURN_SHARP_LEFT |
Keskin bir şekilde sola dönü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 |
Keskin bir şekilde sağa dönün. |
UTURN_RIGHT |
Sağa U dönüşü yapın. |
TURN_RIGHT |
Sağa dönün. |
STRAIGHT |
Düz gidin. |
RAMP_LEFT |
Soldaki rampayı kullanın. |
RAMP_RIGHT |
Doğru rampayı kullanın. |
MERGE |
Trafiğe karışın. |
FORK_LEFT |
Soldaki yolu kullanın. |
FORK_RIGHT |
Sağdaki yoldan gidin. |
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. |
RouteLegStepTravelAdvisory
Kullanıcıya bildirilmesi gereken ek bilgileri (ör. bir ayak adımında 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 tesislerin metin gösterimleri.
| JSON gösterimi |
|---|
{ "distance": { object ( |
| Alanlar | |
|---|---|
distance |
Metin biçiminde gösterilen seyahat mesafesi. |
staticDuration |
Trafik koşulları dikkate alınmadan hesaplanan ve metin biçiminde gösterilen süre. |
RouteLegStepTransitDetails
RouteLegStep ile ilgili TRANSIT rotaları hakkında ek bilgiler.
| JSON gösterimi |
|---|
{ "stopDetails": { object ( |
| Alanlar | |
|---|---|
stopDetails |
Adımın varış ve kalkış durakları hakkında bilgiler. |
localizedValues |
|
headsign |
Araçta veya kalkış durağında belirtildiği şekilde bu hat üzerinde 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 bekleme süresi değeriyle otobüsünüzü kaçırmanız durumunda on dakika beklemeniz gerekir. En fazla dokuz kesirli basamak içeren ve " |
transitLine |
Bu adımda kullanılan toplu taşıma hattı hakkında bilgiler. |
stopCount |
Kalkış durağından varış durağına kadar olan durak sayısı. Bu sayıya varış durağı dahil edilir ancak kalkış durağı dahil edilmez. Örneğin, rotanız A durağından başlıyor, B ve C duraklarından geçip D durağına varıyorsa |
tripShortText |
Yolculara toplu taşıma yolculuğunu tanımlamak için programlarda ve tabelalarda görünen metin. Metin, hizmet verilen gün içinde 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 hareket eden Amtrak treninin |
TransitStopDetails
RouteLegStep için toplu taşıma duraklarıyla ilgili ayrıntılar.
| JSON gösterimi |
|---|
{ "arrivalStop": { object ( |
| Alanlar | |
|---|---|
arrivalStop |
Adımın varış durağıyla ilgili bilgiler. |
arrivalTime |
Adımın 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ın 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
Bir toplu taşıma durağı hakkında bilgi.
| 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 |
Biçimlendirilmiş metin gösteriminde, ilgili saat dilimiyle birlikte zaman. |
departureTime |
Biçimlendirilmiş metin gösteriminde, ilgili saat dilimiyle birlikte zaman. |
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ımlanan 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 |
Toplu taşıma 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. On altılık biçimde gösterilir. |
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ı olur. |
textColor |
Bu hat için tabelalardaki metinlerde yaygın olarak kullanılan renk. On altılık biçimde gösterilir. |
vehicle |
Bu toplu taşıma hattında kullanılan araç türü. |
TransitAgency
Bir toplu taşıma hattını işleten toplu taşıma operatörü.
| JSON gösterimi |
|---|
{ "name": string, "phoneNumber": string, "uri": string } |
| Alanlar | |
|---|---|
name |
Bu transit operatörünün adı. |
phoneNumber |
Toplu taşıma kuruluşunun yerel ayara özgü biçimlendirilmiş telefon numarası. |
uri |
Transit operatörünün URI'si. |
TransitVehicle
Toplu taşıma rotalarında kullanılan araç hakkında bilgiler.
| JSON gösterimi |
|---|
{ "name": { object ( |
| Alanlar | |
|---|---|
name |
Bu aracın adı (büyük harflerle 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 işaretlerine 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ılmamış. |
BUS |
Otobüs |
CABLE_CAR |
Genellikle yerde kablo üzerinde çalışan bir araç. Teleferikler GONDOLA_LIFT türünde olabilir. |
COMMUTER_TRAIN |
Banliyö treni. |
FERRY |
Feribot |
FUNICULAR |
Bir kabloyla dik bir yokuşta çekilen araç. Füniküler genellikle iki vagondan oluşur. Her vagon, diğerinin karşı ağırlığı olarak işlev görür. |
GONDOLA_LIFT |
Teleferik |
HEAVY_RAIL |
Ağır raylı sistem. |
HIGH_SPEED_TRAIN |
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 |
Reklam sütunu |
SHARE_TAXI |
Paylaşımlı taksi, rotası üzerindeki herhangi bir yerde yolcu bırakma ve alma özelliğine sahip bir otobüs türüdür. |
SUBWAY |
Yeraltı hafif raylı sistemi. |
TRAM |
Yer üstü hafif raylı sistem. |
TROLLEYBUS |
Troleybüs. |
RouteLegTravelAdvisory
Kullanıcının bir ayak 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ızlı okuma aralıkları. Bu alan yalnızca istekte Örnek: |
RouteLegLocalizedValues
Belirli tesislerin metin gösterimleri.
| JSON gösterimi |
|---|
{ "distance": { object ( |
| Alanlar | |
|---|---|
distance |
Metin biçiminde gösterilen seyahat mesafesi. |
duration |
Süre, metin biçiminde gösterilir ve sorgunun bulunduğu bölgeye göre yerelleştirilir. Trafik koşullarını dikkate alır. Not: Trafik bilgisi istemediyseniz bu değer, staticDuration ile aynı değerdir. |
staticDuration |
Trafik koşulları dikkate alınmadan hesaplanan ve metin biçiminde gösterilen süre. |
StepsOverview
Bir RouteLegStep listesi hakkında genel bilgiler sağlar.
| JSON gösterimi |
|---|
{
"multiModalSegments": [
{
object ( |
| Alanlar | |
|---|---|
multiModalSegments[] |
|
MultiModalSegment
RouteLeg.steps'nın farklı çok formatlı segmentleri hakkında özetlenmiş bilgiler sağlar. Çok formatlı segment, aynı RouteTravelMode değerine sahip bir veya daha fazla bitişik RouteLegStep olarak tanımlanır. RouteLeg adımlarında çok formatlı segment yoksa bu alan doldurulmaz.
| JSON gösterimi |
|---|
{ "navigationInstruction": { object ( |
| Alanlar | |
|---|---|
navigationInstruction |
Çok formatlı segment için NavigationInstruction. |
travelMode |
Çok formatlı segmentin ulaşım şekli. |
stepStartIndex |
Çok formatlı bir segmentin başlangıcı olan ilgili |
stepEndIndex |
Çok formatlı bir segmentin sonu olan ilgili |
Görüntü alanı
Enlem-boylam görüntü alanı, çapraz olarak zıt iki low ve high noktasıyla gösterilir. Görüntü alanı, kapalı bir bölge olarak kabul edilir. Yani sınırları da görüntü alanına dahildir. 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ı tek bir 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ş olur.low.latitude>high.latitudeise enlem aralığı boş olur.
Hem low hem de high alanları doldurulmalıdır ve gösterilen kutu boş olamaz (yukarıdaki tanımlarda belirtildiği gibi). Boş bir görünüm penceresi hataya neden olur.
Örneğin, bu görünüm penceresi New York City'yi 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 en düşük noktası. |
high |
Zorunlu. Görüntü alanının en yüksek noktası. |
RouteLocalizedValues
Belirli tesislerin metin gösterimleri.
| JSON gösterimi |
|---|
{ "distance": { object ( |
| Alanlar | |
|---|---|
distance |
Metin biçiminde gösterilen seyahat mesafesi. |
duration |
Süre, metin biçiminde gösterilir ve sorgunun bulunduğu bölgeye 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 ve metin biçiminde gösterilen süre. |
transitFare |
Toplu taşıma ücreti metin biçiminde gösterilir. |
PolylineDetails
Belirli bir indekse veya çoklu çizginin bitişik segmentine karşılık gelen ayrıntılar. P_0, P_1, ... , P_N noktalarına sahip bir çoklu çizgi verildiğinde (sıfır tabanlı dizin), 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ı. İstek |
restrictionInfo[] |
Çoklu çizgi boyunca kısıtlama ayrıntıları. Bu alan yalnızca bir istekte |
flyoverInfo[] |
Çoklu çizgi boyunca üstten 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 üzerindeki tünellerle ilgili bilgileri kapsar.
| JSON gösterimi |
|---|
{ "tunnelPresence": enum ( |
| Alanlar | |
|---|---|
tunnelPresence |
Belirli bir çoklu çizgi parçası için tünel olup olmadığını gösterir. |
polylinePointIndex |
Tünelle ilgili bilgilerin çoklu çizgi üzerindeki 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 olmalıdır. |
DOES_NOT_EXIST |
Yol özelliği mevcut değil. |
PolylinePointIndex
Bir ç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 |
Bu ayrıntının çoklu çizgi içindeki başlangıç dizini. |
endIndex |
Çoklu çizgi üzerindeki bu ayrıntının bitiş dizini. |
RestrictionInfo
Çoklu çizgi boyunca çeşitli kısıtlamalarla ilgili bilgileri kapsar.
| JSON gösterimi |
|---|
{ "restrictionPresence": enum ( |
| Alanlar | |
|---|---|
restrictionPresence |
Yalnızca çıkış. Belirli bir çoklu çizgi parçası için kısıtlama olup olmadığını gösterir. |
polylinePointIndex |
Çoklu çizgi boyunca kısıtlamayla ilgili bilgilerin konumu. |
| Belirli bir çoklu çizgi bölümüne uygulanabilecek kısıtlama türlerini kapsar. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır: | |
restrictedHeightMm |
Yükseklik sınırı (milimetre cinsinden). Bu alan, kısıtlanmış yükseklik nedeniyle geçiş engellendiğinde veya belirtilen araç için düşük boşluk oluştuğunda doldurulur. |
restrictedWeightKg |
Ağırlık sınırı (kilogram cinsinden). 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 maddelerin taşınması kısıtlandığında bu alan "doğru" olarak ayarlanır. |
trucksProhibited |
Bu alan, kamyonların yasaklandığı durumlarda doğru olarak ayarlanır. |
| Karşılıklı olarak hariç tutulan alanların sonu. | |
FlyoverInfo
Çoklu çizgi boyunca yer alan üstten görünüm bilgileri içerir.
| JSON gösterimi |
|---|
{ "flyoverPresence": enum ( |
| Alanlar | |
|---|---|
flyoverPresence |
Yalnızca çıkış. Belirli bir çoklu çizgi parçası için üstten görünüm olup olmadığını gösterir. |
polylinePointIndex |
Çoklu çizgi boyunca kuşbakışı ile 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ı gösterir. |
polylinePointIndex |
Çoklu çizgi boyunca dar yolla ilgili bilgilerin konumu. |
BridgeInfo
Çoklu çizgi üzerindeki köprülerle ilgili bilgileri kapsar.
| JSON gösterimi |
|---|
{ "bridgePresence": enum ( |
| Alanlar | |
|---|---|
bridgePresence |
Belirli bir çoklu çizgi parçası için köprü olup olmadığını gösterir. |
polylinePointIndex |
Köprüyle ilgili bilgilerin çoklu çizgi üzerindeki konumu. |
SkywayInfo
Çoklu çizgi boyunca üst geçitlerle ilgili bilgileri kapsar.
| JSON gösterimi |
|---|
{ "skywayPresence": enum ( |
| Alanlar | |
|---|---|
skywayPresence |
Belirli bir çoklu çizgi parçası için üst geçit olup olmadığını gösterir. |
polylinePointIndex |
Çoklu çizgi boyunca yer alan üst geçit ile ilgili bilgilerin konumu. |
GeocodingResults
Başlangıç noktası, varış noktası ve ara noktalar için içerir. Yalnızca adres yol noktaları için doldurulur.GeocodedWaypoints
| JSON gösterimi |
|---|
{ "origin": { object ( |
| Alanlar | |
|---|---|
origin |
Başlangıç noktası coğrafi kodlu ara noktası. |
destination |
Hedef coğrafi kodlu ara nokta. |
intermediates[] |
Her biri, istekte belirtildikleri sıraya göre ara coğrafi kodlu yol noktalarının sıfır tabanlı konumuna karşılık gelen bir dizin alanı içeren ara coğrafi kodlu yol noktalarının listesi. |
GeocodedWaypoint
Ara nokta olarak kullanılan konumlarla ilgili ayrıntılar. Yalnızca adres yol noktaları için doldurulur. Adresin hangi konuma göre coğrafi olarak kodlandığını belirlemek için 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[] |
Sonucun türleri(sıfır veya daha fazla tür etiketi şeklinde). 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 bir eşleşme döndürmediğini gösterir. Yazım hataları ve/veya eksik adres olup olmadığını kontrol etmek için orijinal isteği inceleyebilirsiniz. |
placeId |
Bu sonucun yer kimliği. |
intermediateWaypointRequestIndex |
İstekteki ilgili ara yol noktasının dizini. Yalnızca ilgili ara nokta bir ara nokta ise doldurulur. |