- 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ö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 üstbilgisini kullanarak sağlayabilirsiniz (kullanılabilir URL parametreleri ve üstbilgiler bölümüne bakın). Değer, virgülle ayrılmış alan yolları listesidir. Alan yollarının nasıl oluşturulacağı hakkında 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 ç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 önermez. Bunun nedeni:
- 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 performansının sabit olmasını sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar ek hesaplama süresi gerektirebilir. Tüm alanları veya ü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 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ıdır. 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ı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 yönlendirme tercihini kullanmaya çalışır. Yönlendirme tercihi hata veya aşırı uzun gecikme süresine 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: 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ıdır. 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ıdır. Rotaya ek olarak alternatif rotaların hesaplanıp hesaplanmayacağını belirtir. Ara yol noktaları içeren istekler için alternatif rotalar döndürülmez. |
routeModifiers |
İsteğe bağlıdır. Rotaların hesaplanma şeklini etkileyen, 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ğlamadığınızda, rota isteğinin konumundan görüntüleme dili çıkarılır. |
regionCode |
İsteğe bağlıdır. ccTLD ("üst düzey alan") olarak belirtilen iki karakterli 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 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ıdır. Varsayılan rotaya ek olarak, istek kapsamında hesaplanacak referans rotaları belirtir. Referans rota, varsayılan rotadan farklı bir rota hesaplama amacına sahip olan 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, yanıtta döndürülecek alan maskesinde de belirtilmelidir. |
trafficModel |
İsteğe bağlıdır. Trafikte geçirilen süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, geçmiş ortalamalara dayalı olarak trafikteki tahmini süreyi içeren |
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 |
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 alanda, yedek yanıtla ilgili ayrıntılı bilgiler yer alır. 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'dı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ış çoklu çizgisini belirtir. Rotaya genel bakışı 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 değer ENCODED_POLYLINE'dı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'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 |
Daha kısa mesafeli rota. Bu, deneysel bir özelliktir. Bu özellik,
Bu özellik, ara yol noktaları üzerinden veya |
ExtraComputation
İsteği tamamlarken gerçekleştirilecek ek hesaplamalar. Gelecekte ek 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 |
Rotanın/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 |
Güzergahlar 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 |
Rotalar 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 üst geçit 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 diğerleriyle karşılaştırılacak belirli özelliklerini tanımlamak için yararlı olan |
legs[] |
Rotayı oluşturan ayaklar (ara noktalar arasındaki yol segmentleri) 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[] |
Rotayı gösterirken 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 ve yeniden yönlendirme durumunda rota oluşturulurkenki orijinal amacı karşılamak 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, istekler arasında değerini karşılaştırmayın. NOT: |
polylineDetails |
Çoklu çizgi üzerindeki ayrıntılarla ilgili bilgileri içerir. |
RouteLabel
Rotanın diğerleriyle karşılaştırılacak belirli özelliklerini tanımlamak için yararlı olan etiketleri.Route
| Sıralamalar | |
|---|---|
ROUTE_LABEL_UNSPECIFIED |
Varsayılan: Kullanılmaz. |
DEFAULT_ROUTE |
Rota hesaplaması için varsayılan "en iyi" rota döndürülür. |
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 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 seyahat mesafesi (metre cinsinden). |
duration |
Ayağın hareket etmesi için gereken süre. En fazla dokuz kesirli basamak içeren ve " |
staticDuration |
Trafik koşullarının dikkate alınmadığı, rotanın bir bölümündeki 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 ayağın içindeki 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 çizgi 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 olarak 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 dışlayan 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 seyahat mesafesi (metre cinsinden). 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 |
Gezinme talimatları. |
travelAdvisory |
Bir ayak adımında, kullanıcının 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 gezinme işlemini (örneğin, sola dönme, birleşme veya düz gitme) belirten bir değerler grubu.
| 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 |
Sağdaki rampaya girin. |
MERGE |
Trafiğe karışın. |
FORK_LEFT |
Soldaki yolu seçin. |
FORK_RIGHT |
Sağdaki yolu seç. |
FERRY |
Feribota binin. |
FERRY_TRAIN |
Feribota giden treni kullanın. |
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ışı belirtmek için kullanılır. |
RouteLegStepTravelAdvisory
Kullanıcının bilgilendirilmesi 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 özelliklerin 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 için TRANSIT rotalarıyla ilgili 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 duraktır. |
headway |
Bu saatte aynı duraktan kalkışlar arasındaki süre olarak beklenen zamanı belirtir. Örneğin, 600 saniyelik bir bekleme süresi değeriyle otobüsünüzü kaçırdığınızda 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şlayıp B ve C duraklarından geçerek D durağına ulaşıyorsa |
tripShortText |
Programlarda ve tabelalarda yolculara toplu taşıma yolculuğunu tanımlamak için gösterilen metin. Metin, 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, CA'dan Sacramento, CA'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
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ı. |
TransitDetailsLocalizedValues
RouteTransitDetails için değerlerin yerelleştirilmiş açıklamaları.
| JSON gösterimi |
|---|
{ "arrivalTime": { object ( |
| Alanlar | |
|---|---|
arrivalTime |
Biçimlendirilmiş metin gösterimi ve ilgili saat dilimiyle birlikte saat. |
departureTime |
Biçimlendirilmiş metin gösterimi ve ilgili saat dilimiyle birlikte 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ı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ı (ör. "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. Onaltı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 satır numarası olur. |
textColor |
Bu hat için tabelalardaki metinlerde yaygın olarak kullanılan renk. Onaltı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 |
Toplu taşıma operatörünün URI'si. |
TransitVehicle
Toplu taşıma güzergahlarında kullanılan araçla ilgili 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ılmıyor. |
BUS |
Otobüs |
CABLE_CAR |
Genellikle yerde kablo üzerinde hareket eden bir araç. Teleferikler GONDOLA_LIFT türünde olabilir. |
COMMUTER_TRAIN |
Banliyö treni. |
FERRY |
Feribot |
FUNICULAR |
Kabloyla dik bir yokuş 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 |
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 |
Zemin ü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 özelliklerin metin gösterimleri.
| JSON gösterimi |
|---|
{ "distance": { object ( |
| Alanlar | |
|---|---|
distance |
Metin biçiminde gösterilen seyahat mesafesi. |
duration |
Metin biçiminde gösterilen ve sorgunun bölgesine göre yerelleştirilmiş süre. 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ı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 ulaşım şekli. |
stepStartIndex |
Çok formatlı bir segmentin başlangıcı olan ilgili |
stepEndIndex |
Çok formatlı bir segmentin sonunu oluşturan 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 alanı hataya neden olur.
Örneğin, bu görünüm penceresi New York şehrini tamamen kapsıyor:
{ "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 özelliklerin metin gösterimleri.
| JSON gösterimi |
|---|
{ "distance": { object ( |
| Alanlar | |
|---|---|
distance |
Metin biçiminde gösterilen seyahat mesafesi. |
duration |
Metin biçiminde gösterilen ve sorgunun bölgesine göre yerelleştirilmiş süre. 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 (sıfır tabanlı dizin) 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ı. Bu alan, istekte |
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 boyunca tünellerle ilgili bilgileri kapsar.
| JSON gösterimi |
|---|
{ "tunnelPresence": enum ( |
| Alanlar | |
|---|---|
tunnelPresence |
Poliline'ın belirli bir bölümünde tünel olup olmadığını gösterir. |
polylinePointIndex |
Tünelle ilgili bilgilerin çoklu çizgi üzerindeki konumu. |
RoadFeatureState
Ç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
Bir çoklu çizgi ayrıntısının başlangıç ve bitiş indekslerini 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ış. Çoklu çizginin belirli bir bölümünde kısıtlama olup olmadığını gösterir. |
polylinePointIndex |
Çoklu çizgi boyunca kısıtlamayla ilgili bilgilerin konumu. |
| Çoklu çizginin belirli bir 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 olarak en fazla bir alan ayarlanır: | |
restrictedHeightMm |
Yükseklik sınırı (milimetre). 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 "true" olarak ayarlanır. |
| Birbirini dışlayan alanların sonu. | |
FlyoverInfo
Çoklu çizgi boyunca üstten görünümle ilgili bilgileri kapsar.
| JSON gösterimi |
|---|
{ "flyoverPresence": enum ( |
| Alanlar | |
|---|---|
flyoverPresence |
Yalnızca çıkış. Belirli bir çoklu çizgi parçası için kuşbakışı görünümün 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 yolun 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 |
Poliline'ın belirli bir bölümünde üst geçit olup olmadığını gösterir. |
polylinePointIndex |
Çoklu çizgi boyunca ü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 nokta konumunun sıfır tabanlı konumuna karşılık gelen bir dizin alanı içeren, ara coğrafi kodlu ara noktaların listesi. |
GeocodedWaypoint
Ara nokta olarak kullanılan konumlarla ilgili ayrıntılar. Yalnızca adres yol noktaları için doldurulur. Adresin hangi coğrafi kodla 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 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. |