Method: computeRoutes

İstenen seyahat modu için istenen başlangıç ve varış noktası arasındaki birincil rotayı döndürür.

HTTP isteği

POST https://mapstools.googleapis.com/v1: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 (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "departureTime": string,
  "arrivalTime": string
  // End of mutually exclusive fields.
}
Alanlar
origin

object (Waypoint)

Zorunlu. Başlangıç noktası ara noktası.
destination

object (Waypoint)

Zorunlu. Hedef ara nokta.
travelMode

enum (RouteTravelMode)

İsteğe bağlı. Ulaşım şeklini belirtir.
intermediateWaypoints[]

object (Waypoint)

İsteğe bağlı. Başlangıç ve varış noktası arasında sırayla geçilecek ara duraklar. En fazla 25 ara nokta desteklenir.

10'dan fazla ara nokta belirtmek daha yüksek maliyete ve daha yüksek gecikmeye neden olur. travelMode, TRANSIT olduğunda ara noktalar desteklenmez.
routingPreference

enum (RoutingPreference)

İsteğe bağlı. Trafik verilerinin rotayı hesaplamak için nasıl kullanılacağını belirler. travelMode, WALK veya BICYCLE olduğunda ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL desteklenmez. TRANSIT için gecikmeler ve iptaller gibi anlık toplu taşıma verilerini etkinleştirir.
locationBias

object (LatLng)

İsteğe bağlı. Arama sonuçlarının yönlendirileceği bir konum (ör. ara nokta metin sorgularının anlam belirsizliğini gidermek için).
includePolyline

boolean

İsteğe bağlı. Kodlanmış çoklu çizginin yanıt rotalarına dahil edilip edilmeyeceği. Varsayılan değer false'dir. true olarak ayarlandığında Route.encoded_polyline döndürülür.
computeAlternativeRoutes

boolean

İsteğe bağlı. Önerilen rotaya ek olarak alternatif rotaların hesaplanıp hesaplanmayacağı. Varsayılan olarak false değerine ayarlanır. Bu durumda yalnızca önerilen rota döndürülür. Doğru değerine ayarlandığında, her istek için alternatifler mevcut olmasa da mevcut tüm rotalar döndürülür.
Başlangıç noktasından ne zaman ayrılacağınızı veya son ara noktaya ne zaman varacağınızı belirtir. Belirtilmezse varsayılan olarak geçerli saatte kalkış yapılır. TRANSIT için zaman, en fazla 7 gün önce ve en fazla 100 gün sonra olmalıdır. Diğer seyahat modları için zaman geçmişte olmamalı ve gelecekte en fazla 365 gün olmalıdır. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
departureTime

string (Timestamp format)

İsteğe bağlı. Rotanın kalkış saatine göre hesaplanması gerektiğini belirtir.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
arrivalTime

string (Timestamp format)

İsteğe bağlı. Rotanın varış zamanına göre hesaplanması gerektiğini belirtir.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
Birbirini hariç tutan alanların sonu.

Yanıt metni

Başarılıysa yanıt metni, ComputeRoutesResponse öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/maps-platform.mapstools