Rota boyunca durak ayarlayın

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Bir rotada durak ayarlamak için iki yöntemden birini kullanabilirsiniz. Örneğin, birini teslim almak veya bir yere bırakmak için durak ayarlayabilirsiniz:

  • Ara nokta ekleme: Bu, varsayılan seçenektir. intermediates dizisinde başlangıç noktası ile hedef arasına bir ara nokta ekleyin. Yönlendirme motoru, ara noktayı en yakın gezilebilir yola sabitler ve rotayı, bu durakla bağlantılı RouteLeg segmente böler.
  • vehicleStopover belirtin: Rota motorunun, durmaya uygun olmayan yol segmentlerinden (ör. otoyollar, tüneller veya üst geçitler) kaçınmak için ek analiz yapmasını istiyorsanız bir ara nokta üzerinde vehicleStopover: true değerini ayarlayın.

Ara nokta ekleme

Bir rota üzerinde durak ayarlamak için isteğinizdeki intermediates dizisine ara yol noktası ekleyin.

Ara nokta eklemenin etkileri şunlardır:

  • Rota, RouteLeg segmente ayrılır: Her segment, bir durağı bir sonrakine bağlar.
  • Koordinat bir yola sabitleniyor: Rota motoru, enlem ve boylam koordinatınızı (çatı veya bahçede olabilir) en yakın gezilebilir yol segmentine sabitler.

Birçok ana cadde için en yakın yola tutturma, pratik bir durak konumu sağlar. Ancak sabitleme, en yakın yol bir otoyol veya tünel olduğunda olduğu gibi, söz konusu yol segmentinin kenara çekilmek için uygun olup olmadığını belirlemez.

Örnek: Ara nokta ekleme

Aşağıdaki örnekte, computeRoutes POST isteğine ara yol noktası ekleyerek bir rota üzerinde durak ayarlama işlemi gösterilmektedir:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Ara duraklar ve rota ayakları hakkında daha fazla bilgi için Ara durak ayarlama başlıklı makaleyi inceleyin.

Alma ve bırakma uygunluğu için bir vehicleStopover belirtin

Standart bir ara nokta en yakın yola tutturulsa da bu yol her zaman araçla durmaya uygun olmayabilir. Rota motorunun, yolun teslim alma veya bırakma için uygunluğunu değerlendirmek üzere ek analiz yapmasını istediğinizde ara noktada vehicleStopover: true ayarını yapın.

vehicleStopover: true ayarını yaptığınızda yönlendirme motoru, olası yol segmentlerini değerlendirir ve durmaya uygun olmayan yollardan (ör. otobanlar, tüneller ve üst geçitler) kaçınmaya çalışır.

Örneğin, bir tünelin içindeki otoyolun doğrudan üzerinden geçen bir yüzey yolunu ele alalım: * Standart ara nokta: Geometrik olarak koordinatınıza daha yakınsa otoyola veya tünele tutturulur. * Araçla mola: Otoyol ve tüneli atlamak için ek analizler yapar ve molayı, kenara çekilmeye uygun bir yüzey yoluna yerleştirir.

Örnek: Bir ara noktada vehicleStopover'ı belirtme

Aşağıdaki örnekte, tam bir POST isteğinde ara yol noktasına vehicleStopover: true değerinin nasıl ayarlanacağı gösterilmektedir:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      },
      "vehicleStopover": true
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Ara nokta türleri ve seçenekleri hakkında daha fazla bilgi için Ara nokta türleri ve seçenekleri başlıklı makaleyi inceleyin.