- 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
- GeocodingResults
- GeocodedWaypoint
Bir dizi terminal ve ara yol noktası verildiğinde, birincil rotayı ve isteğe bağlı alternatif rotaları 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 ü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 yolları listesidir. Alan yollarının nasıl oluşturulacağı hakkında ayrıntılı dokümanları inceleyin.
Ö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 poli çizginin alan maskesi (örnek ü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 nedeni:
- Yalnızca ihtiyacınız olan alanları seçmek, sunucumuzun hesaplama döngülerinde tasarruf etmesine yardımcı olur. Bu da sonucu size daha düşük gecikmeli olarak döndürmemize olanak tanır.
- Üretim işinizde yalnızca ihtiyacınız olan alanları seçmek, kararlı bir gecikme performansı 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 ekleyeceğimiz yeni alanlar yanıta otomatik olarak dahil edileceğinden performansta düşüş yaşayabilirsiniz.
- Yalnızca ihtiyacınız olan alanları seçmek, yanıt boyutunun küçülmesine ve dolayısıyla ağ aktarım hızının artmasına neden olur.
HTTP isteği
POST https://routes.googleapis.com/directions/v2:computeRoutes
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
İstek içeriği
İstek metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "origin": { object ( |
Alanlar | |
---|---|
origin |
Zorunlu. Başlangıç ara noktası. |
destination |
Zorunlu. Hedef yol noktası. |
intermediates[] |
İsteğe bağlı. Rota üzerinde, duraklamak veya geçmek için bir dizi yol noktası (terminal noktaları hariç). En fazla 25 ara nokta desteklenir. |
travel |
İsteğe bağlı. Ulaşım şeklini belirtir. |
routing |
İ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 hatayla veya aşırı uzun bir gecikmeye neden olursa bir hata döndürülür. Bu seçeneği yalnızca |
polyline |
İsteğe bağlı. Poli çizginin kalitesiyle ilgili tercihinizi belirtir. |
polyline |
İsteğe bağlı. Poli çizgi için tercih edilen kodlamayı belirtir. |
departure |
İsteğe bağlı. Kalkış saati. Bu değeri ayarlamazsanız varsayılan olarak isteği gönderdiğiniz saat kullanılır. NOT: Yalnızca Nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
arrival |
İsteğe bağlı. Varış saati. NOT: Yalnızca Nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
compute |
İsteğe bağlı. Rotaya ek olarak alternatif rotaların hesaplanıp hesaplanmayacağını belirtir. Ara yol işaretleri içeren istekler için alternatif rota döndürülmez. |
route |
İsteğe bağlı. Yolların hesaplanma şeklini etkileyen ve karşılanması gereken bir dizi koşul. |
language |
İsteğe bağlı. BCP-47 dil kodu ("en-US" veya "sr-Latn" gibi). 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 ekran dili, rota isteğinin konumundan anlaşılır. |
region |
İsteğe bağlı. ccTLD ("üst düzey alan") iki karakterli değer 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ı. Gösterge alanları için ölçü birimlerini belirtir. Bu alanlar, |
optimize |
İsteğe bağlı. Doğru olarak ayarlanırsa hizmet, belirtilen ara yol işaretlerini yeniden düzenleyerek rotanın toplam maliyetini en aza indirmeye çalışır. Ara yol işaretçilerinden herhangi biri |
requested |
İ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 bir rotadır. Örneğin, |
extra |
İ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, yanıtta döndürülecek şekilde alan maskesinde de belirtilmelidir. |
traffic |
İsteğe bağlı. Trafikte geçirilen süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, geçmiş ortalamalara göre trafikte tahmini süreyi içeren |
transit |
İsteğe bağlı. |
Yanıt gövdesi
v2.computeRoutes, yanıt mesajını oluşturur.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "routes": [ { object ( |
Alanlar | |
---|---|
routes[] |
|
fallback |
Sunucu, rota sonuçlarını tüm giriş tercihleriyle hesaplayamadığında farklı bir hesaplama yöntemi kullanabilir. Yedek modu kullanıldığında bu alan, yedek yanıtla ilgili ayrıntılı bilgi içerir. Aksi takdirde bu alanın değeri belirlenmez. |
geocoding |
Adres olarak belirtilen yol işaretleri için coğrafi kodlama yanıt bilgilerini içerir. |
PolylineQuality
Poli çizginin kalitesini belirten bir değer kümesi.
Sıralamalar | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Poli çizgi kalitesi tercihi belirtilmedi. Varsayılan olarak OVERVIEW değerine ayarlanır. |
HIGH_QUALITY |
Yanıt boyutunun artması pahasına OVERVIEW 'ten daha fazla nokta kullanılarak oluşturulan yüksek kaliteli bir çok ç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ış poli çizgisini belirtir. Rotaya genel bakış gösterilirken bu değeri kullanın. Bu seçenek, HIGH_QUALITY seçeneğine kıyasla daha düşük istek gecikmesi sunar. |
PolylineEncoding
Döndürülecek tercih edilen çoklu çizgi türünü belirtir.
Sıralamalar | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Poli çizgi türü tercihi belirtilmedi. Varsayılan olarak ENCODED_POLYLINE değerine ayarlanır. |
ENCODED_POLYLINE |
Poli çizgisi kodlama algoritması kullanılarak kodlanmış bir poli çizgiyi belirtir. |
GEO_JSON_LINESTRING |
GeoJSON LineString biçimini kullanarak bir çok çizgi belirtir. |
ReferenceRoute
ComputeRoutesRequest üzerinde desteklenen bir referans rotası.
Sıralamalar | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Kullanılmadı. 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, ara yol noktaları veya |
ExtraComputation
İsteği tamamlarken yapılacak ek hesaplamalar.
Sıralamalar | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Kullanılmadı. 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 trafik bilinçli çoklu çizgiler. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions biçimlendirilmiş HTML metin dizesi olarak sunulur. Bu içerik olduğu gibi okunmak üzere tasarlanmıştır. Bu içerik yalnızca görüntüleme amaçlıdır. Programlı olarak ayrıştırmayın. |
Rota
Başlangıç, bitiş ve ara yol noktalarını birleştiren bir dizi bağlı yol segmentinden oluşan bir rota içerir.
JSON gösterimi |
---|
{ "routeLabels": [ enum ( |
Alanlar | |
---|---|
route |
|
legs[] |
Rotayı oluşturan yol segmentleri (ara noktalar arasındaki yol segmentleri) koleksiyonu. Her aşama, |
distance |
Rotayı katedilen mesafe (metre cinsinden). |
duration |
Rotada gezinmek için gereken süre. En fazla dokuz kesirli basamak içeren ve " |
static |
Trafik koşulları dikkate alınmadan rotadaki seyahat süresi. En fazla dokuz kesirli basamak içeren ve " |
polyline |
Genel rota çoklu çizgisi. Bu çoklu çizgi, tüm |
description |
Rotayı açıklayan bir metin. |
warnings[] |
Rota gösterilirken gösterilecek uyarı dizisi. |
viewport |
Çoklu çizginin görüntü alanı sınırlayıcı kutusu. |
travel |
Rota hakkında ek bilgiler. |
optimized |
|
localized |
|
route |
Navigasyon sırasında rotayı yeniden oluşturmak ve yeniden yönlendirme durumunda rotanın oluşturulduğu orijinal amacı dikkate almak için Navigation SDK'ya iletilebilecek 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: |
RouteLabel
için, rotanın diğerleriyle karşılaştırılacak belirli özelliklerini 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 çevre dostu parametreler için optimize edildiği belirlenir. |
SHORTER_DISTANCE |
Daha kısa seyahat mesafesi olan rota. Bu, deneysel bir özelliktir. |
RouteLeg
via
olmayan yol işaretleri arasında bir segment içerir.
JSON gösterimi |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Alanlar | |
---|---|
distance |
Rota adımını oluşturan seyahat mesafesi (metre cinsinden). |
duration |
Bacak boyunca gezinmek için gereken süre. En fazla dokuz kesirli basamak içeren ve " |
static |
Trafik koşulları dikkate alınmadan hesaplanan, yol boyunca seyahat süresi. En fazla dokuz kesirli basamak içeren ve " |
polyline |
Her |
start |
Bu etabın başlangıç konumu. Bu konum, sağlanan |
end |
Bu etabın bitiş konumu. Bu konum, sağlanan |
steps[] |
Bu ayaktaki segmentleri belirten bir adım dizisi. Her adım bir gezinme talimatını temsil eder. |
travel |
Bir rota adımında olası trafik bölgesi kısıtlamaları gibi kullanıcının bilgilendirilmesi gereken ek bilgileri içerir. |
localized |
|
steps |
Bu |
Çoklu çizgi
Kodlanmış bir çoklu çizgiyi kapsüller.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birlik alanı polyline_type . Çoklu çizginin türünü kapsar. Varsayılan olarak encoded_polyline değerine ayarlanır. polyline_type yalnızca aşağıdakilerden biri olabilir: |
|
encoded |
Poli çizgisi kodlama algoritması kullanılarak poli çizgisinin dize kodlaması |
geo |
GeoJSON LineString biçimini kullanarak bir çok çizgi belirtir. |
RouteLegStep
segmenti içerir. Bir adım, tek bir gezinme talimatına karşılık gelir. Rota bacakları adımlardan oluşur.RouteLeg
JSON gösterimi |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Alanlar | |
---|---|
distance |
Bu adımın kat edilen mesafesi (metre cinsinden). Bazı durumlarda bu alanın değeri olmayabilir. |
static |
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. |
start |
Bu adımın başlangıç konumu. |
end |
Bu adımın bitiş konumu. |
navigation |
Gezinme talimatları. |
travel |
Bir yol adımında kullanıcıya bildirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir. |
localized |
|
transit |
Seyahat modu |
travel |
Bu adımda kullanılan ulaşım şekli. |
Manevra
Mevcut adım için yapılacak gezinme işlemini (ör. sola dön, birleş veya düz git) belirten bir değer kümesi.
Sıralamalar | |
---|---|
MANEUVER_UNSPECIFIED |
Kullanılmadı. |
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 |
Sol rampadan gidin. |
RAMP_RIGHT |
Sağ rampaya girin. |
MERGE |
Trafik akışı ile birleşin. |
FORK_LEFT |
Sol çataldan gidin. |
FORK_RIGHT |
Sağ çataldan gidin. |
FERRY |
Feribota binin. |
FERRY_TRAIN |
Feribota giden trene binin. |
ROUNDABOUT_LEFT |
Dönel kavşakta sola dönün. |
ROUNDABOUT_RIGHT |
Dönel kavşakta sağa dönün. |
DEPART |
İlk manevra. |
NAME_CHANGE |
Cadde adı değişikliğini belirtmek için kullanılır. |
RouteLegStepTravelAdvisory
Bir yol adımı üzerindeki olası trafik bölgesi kısıtlamaları gibi kullanıcının bilgilendirilmesi gereken ek bilgileri içerir.
JSON gösterimi |
---|
{
"speedReadingIntervals": [
{
object ( |
Alanlar | |
---|---|
speed |
NOT: Bu alan şu anda doldurulmamıştır. |
RouteLegStepLocalizedValues
Belirli tesislerin metin temsilleri.
JSON gösterimi |
---|
{ "distance": { object ( |
Alanlar | |
---|---|
distance |
Metin biçiminde gösterilen seyahat mesafesi. |
static |
Trafik koşulları dikkate alınmadan hesaplanan ve metin biçiminde gösterilen süre. |
RouteLegStepTransitDetails
TRANSIT
rotalarıyla ilgili RouteLegStep
için ek bilgiler.
JSON gösterimi |
---|
{ "stopDetails": { object ( |
Alanlar | |
---|---|
stop |
Adımın varış ve kalkış duraklarıyla ilgili bilgiler. |
localized |
|
headsign |
Araç üzerinde veya kalkış durağında belirtildiği şekilde, bu hatta seyahat edilecek yönü belirtir. Yön genellikle son duraktır. |
headway |
Bu saatte aynı duraktan yapılan kalkışlar arasındaki süre olarak beklenen zamanı belirtir. Örneğin, 600 saniyelik bir sefer aralığı değeriyle, otobüsünüz kaçırırsanız on dakika beklemeniz gerekir. En fazla dokuz kesirli basamak içeren ve " |
transit |
Bu adımda kullanılan toplu taşıma hattı hakkında bilgi. |
stop |
Kalkış durağından varış duraklarına kadar olan durak sayısı. Bu sayıya varış durağı dahildir ancak kalkış durağı hariçtir. Örneğin, rotanız A durağından kalkıyor, B ve C duraklarından geçiyor ve D durağına varıyorsa
3 değerini döndürür. |
trip |
Yolculara toplu taşıma yolculuğunu tanımlamak için sefer tarifelerinde ve tabelalarda görünen metin. Metin, bir hizmet günü içindeki bir geziyi benzersiz bir şekilde tanımlamalıdır. Örneğin, "538", hafta içi saat 15:10'da San Jose, CA'dan Sacramento, CA'ya giden Amtrak treninin |
TransitStopDetails
RouteLegStep
için toplu taşıma duraklarıyla ilgili ayrıntılar.
JSON gösterimi |
---|
{ "arrivalStop": { object ( |
Alanlar | |
---|---|
arrival |
Adımın varış durağı hakkında bilgi. |
arrival |
Adımın tahmini varış zamanı. Nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
departure |
Adımın kalkış durağı hakkında bilgi. |
departure |
Adımın tahmini kalkış zamanı. Nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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ıyla ifade edilen konumu. |
TransitDetailsLocalizedValues
RouteTransitDetails
değerlerinin yerelleştirilmiş açıklamaları.
JSON gösterimi |
---|
{ "arrivalTime": { object ( |
Alanlar | |
---|---|
arrival |
Saat, ilgili saat dilimiyle birlikte biçimlendirilmiş metin temsilinde. |
departure |
Saat, ilgili saat dilimiyle birlikte biçimlendirilmiş metin temsilinde. |
LocalizedTime
Yerelleştirilmiş saat açıklaması.
JSON gösterimi |
---|
{
"time": {
object ( |
Alanlar | |
---|---|
time |
Belirli bir saat diliminde dize olarak belirtilen saat. |
time |
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 olarak gösterilir. |
icon |
Bu satırla ilişkili simgenin URI'si. |
name |
Bu toplu taşıma hattının kısa adı. Bu ad genellikle bir satır numarası olur (ör. "M7" veya "355"). |
text |
Bu satırın tabelalarındaki metinde yaygın olarak kullanılan renk. On altılık olarak gösterilir. |
vehicle |
Bu toplu taşıma hattında çalışan aracın türü. |
TransitAgency
Bir toplu taşıma hattını işleten transit operatörü.
JSON gösterimi |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
Alanlar | |
---|---|
name |
Bu toplu taşıma işletmesinin adı. |
phone |
Toplu taşıma acentesinin yerel ayara özel biçimlendirilmiş telefon numarası. |
uri |
Transit operatörünün URI'si. |
TransitVehicle
Toplu taşıma rotalarında kullanılan bir araçla ilgili bilgiler.
JSON gösterimi |
---|
{ "name": { object ( |
Alanlar | |
---|---|
name |
Bu aracın adı, büyük harflerle. |
type |
Kullanılan aracın türü. |
icon |
Bu araç türüyle ilişkili bir simgenin URI'si. |
local |
Yerel ulaşım tabelalarına göre bu araç türüyle ilişkili simgenin URI'si. |
TransitVehicleType
Toplu taşıma rotalarındaki araç türü.
Sıralamalar | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
Kullanılmamış. |
BUS |
Otobüs. |
CABLE_CAR |
Genellikle yerde kabloyla çalışan bir araç. Teleferikler GONDOLA_LIFT türü olabilir. |
COMMUTER_TRAIN |
Banliyö treni. |
FERRY |
Feribot. |
FUNICULAR |
Dik yokuşları kabloyla yukarı çekilen araç. Teleferik genellikle iki arabadan oluşur ve her araba diğerine 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 |
Şehirlerarası otobüs. |
LONG_DISTANCE_TRAIN |
Uzun mesafeli tren. |
METRO_RAIL |
Hafif raylı sistem. |
MONORAIL |
Monoray. |
OTHER |
Diğer tüm araçlar. |
RAIL |
Demiryolu. |
SHARE_TAXI |
Paylaşılan taksi, güzergahındaki herhangi bir yerde yolcu alıp bırakabilen 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 yol adımı sırasında bilgilendirilmesi gereken ek bilgileri (ör. olası trafik bölgesi kısıtlamaları) içerir.
JSON gösterimi |
---|
{ "tollInfo": { object ( |
Alanlar | |
---|---|
toll |
Belirli bir |
speed |
Trafik yoğunluğunu ayrıntılı olarak gösteren hız okuma aralıkları. Örnek:
|
RouteLegLocalizedValues
Belirli tesislerin metin temsilleri.
JSON gösterimi |
---|
{ "distance": { object ( |
Alanlar | |
---|---|
distance |
Metin biçiminde gösterilen seyahat mesafesi. |
duration |
Metin biçiminde gösterilen ve sorgunun bulunduğu bölgeye göre yerelleştirilen süre. Trafik koşullarını dikkate alır. Not: Trafik bilgileri istemediyseniz bu değer, staticDuration ile aynıdır. |
static |
Trafik koşulları dikkate alınmadan hesaplanan ve metin biçiminde gösterilen süre. |
StepsOverview
RouteLegStep
listesi hakkında genel bilgiler sağlar.
JSON gösterimi |
---|
{
"multiModalSegments": [
{
object ( |
Alanlar | |
---|---|
multi |
|
MultiModalSegment
RouteLeg.steps
'ün farklı çok modlu segmentleri hakkında özet bilgiler 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 modlu segment içermiyorsa bu alan doldurulmaz.
JSON gösterimi |
---|
{ "navigationInstruction": { object ( |
Alanlar | |
---|---|
navigation |
Çok modlu segment için NavigationInstruction. |
travel |
Çok modlu segmentin ulaşım şekli. |
step |
Çok modlu bir segmentin başlangıcı olan ilgili |
step |
Çok modlu bir segmentin sonu olan ilgili |
Görüntü alanı
Çapraz olarak karşı karşıya iki low
ve high
noktası olarak gösterilen bir enlem-boylam görüntü alanı. Görüntü alanı kapalı bir bölge olarak kabul edilir. Yani görüntü alanı, sınırını içerir. Enlem sınırları -90 ile 90 derece (dahil) arasında, boylam sınırları ise -180 ile 180 derece (dahil) arasında olmalıdır. Bu tür durumlara örnek olarak şunlar verilebilir:
low
=high
ise görüntü alanı tek bir noktadan oluşur.low.longitude
>high.longitude
ise boylam aralığı tersine ç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.latitude
ise 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). Boş bir görüntü alanı hataya neden olur.
Örneğin, bu görüntü alanı New York'u 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 alt noktası. |
high |
Zorunlu. Görüntü alanının en yüksek noktası. |
RouteLocalizedValues
Belirli tesislerin metin temsilleri.
JSON gösterimi |
---|
{ "distance": { object ( |
Alanlar | |
---|---|
distance |
Metin biçiminde gösterilen seyahat mesafesi. |
duration |
Metin biçiminde gösterilen ve sorgunun bulunduğu bölgeye göre yerelleştirilen süre. Trafik koşullarını dikkate alır. Not: Trafik bilgileri isteğinde bulunmadıysanız bu değer |
static |
Trafik koşulları dikkate alınmadan hesaplanan ve metin biçiminde gösterilen süre. |
transit |
Toplu taşıma ücreti, metin biçiminde gösterilir. |
GeocodingResults
Başlangıç, hedef ve ara yol işaretleri için
içerir. Yalnızca adres yol noktaları için doldurulur.GeocodedWaypoints
JSON gösterimi |
---|
{ "origin": { object ( |
Alanlar | |
---|---|
origin |
Coğrafi kodlanmış başlangıç noktası. |
destination |
Coğrafi kodlanmış hedef yol noktası. |
intermediates[] |
Her biri, istekte belirtildikleri sırada yol işaretinin sıfır tabanlı konumuna karşılık gelen bir dizin alanı içeren, coğrafi olarak kodlanmış ara yol işaretlerinin listesi. |
GeocodedWaypoint
Dönüm noktası olarak kullanılan konumlarla ilgili ayrıntılar. Yalnızca adres yol işaretleri için doldurulur. Adresin coğrafi kodlamanın hangi konuma göre yapıldığını belirlemek için coğrafi kodlama sonuçlarıyla ilgili ayrıntıları içerir.
JSON gösterimi |
---|
{
"geocoderStatus": {
object ( |
Alanlar | |
---|---|
geocoder |
Coğrafi kodlama işleminden kaynaklanan durum kodunu belirtir. |
type[] |
Sonuç türleri(sıfır veya daha fazla tür etiketi biçiminde). Desteklenen türler: Adres türleri ve adres bileşeni türleri. |
partial |
Coğrafi kodlayıcı, istenen adresin bir kısmını eşleştirebilmesine rağmen orijinal istek için tam eşleşme döndürmedi. Orijinal isteği yazım hataları ve/veya eksik adres olup olmadığını kontrol etmek isteyebilirsiniz. |
place |
Bu sonucun yer kimliği. |
intermediate |
İstekteki ilgili ara yol noktasının dizini. Yalnızca ilgili yol noktası ara yol noktasıysa doldurulur. |