- HTTP isteği
- İstek metni
- Yanıt metni
- RouteMatrixOrigin
- RouteMatrixDestination (Rota Matrisi Hedefi)
- ExtraComputation
- RouteMatrixElementCondition
- LocalizedValues
Başlangıç ve varış noktalarının listesini alır ve her bir kalkış ve hedef kombinasyonu için rota bilgilerini içeren bir akış 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 başlığını kullanarak sağlayabilirsiniz (kullanılabilir URL parametreleri ve başlıklarına bakın). Değer, alan yollarının virgülle ayrılmış bir listesidir. Alan yollarının nasıl oluşturulacağı ile ilgili bu ayrıntılı belgeleri inceleyin.
Örneğin, bu yöntemde:
- Mevcut tüm alanların alan maskesi (manuel inceleme için):
X-Goog-FieldMask: *
- Rota süreleri, mesafeler, öğe durumu, durum ve öğe dizinlerinin alan maskesi (örnek üretim kurulumu):
X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration
Alan maskenize status
eklemeniz gerekir. Aksi takdirde, tüm iletiler sorunsuz görünür. Google, joker karakter (*
) yanıt alanı maskesinin kullanılmasını önermez, çünkü:
- Yalnızca ihtiyacınız olan alanları seçmeniz, sunucumuzun hesaplama döngülerini kaydetmesine yardımcı olarak sonucu size daha düşük bir gecikmeyle sunmamıza olanak tanır.
- Üretim işinizde yalnızca ihtiyacınız olan alanların seçilmesi, gecikme performansının istikrarlı olmasını sağlar. Gelecekte daha fazla yanıt alanı ekleyebiliriz ve bu yeni alanlar ekstra hesaplama süresi gerektirebilir. Tüm alanları seçerseniz veya en üst düzeydeki tüm alanları seçerseniz, eklediğimiz yeni alanlar yanıta otomatik olarak dahil edileceğinden performansta düşüş yaşayabilirsiniz.
- Yalnızca ihtiyacınız olan alanların seçilmesi, daha küçük bir yanıt boyutuyla ve dolayısıyla daha yüksek ağ işleme hızıyla sonuçlanır.
HTTP isteği
POST https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
İstek içeriği
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{ "origins": [ { object ( |
Alanlar | |
---|---|
origins[] |
Zorunlu. Yanıt matrisinin satırlarını belirleyen kaynaklar dizisi. Başlangıç noktalarının ve hedeflerin kardinalitesi için çeşitli boyut kısıtlamaları geçerlidir:
|
destinations[] |
Zorunlu. Yanıt matrisinin sütunlarını belirleyen hedef dizisi. |
travelMode |
İsteğe bağlı. Ulaşım şeklini belirtir. |
routingPreference |
İsteğe bağlı. Rotanın nasıl hesaplanacağını belirtir. Sunucu, yolu hesaplamak için seçili yönlendirme tercihini kullanmayı dener. Yönlendirme tercihi hataya veya ekstra uzun gecikmeye yol açarsa hata döndürülür. Bu seçeneği yalnızca |
departureTime |
İsteğe bağlı. Kalkış saati. Bu değeri ayarlamazsanız bu değer varsayılan olarak, istekte bulunduğunuz zamana ayarlanır. NOT: Yalnızca Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
arrivalTime |
İsteğe bağlı. Varış saati. NOT: Yalnızca Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
languageCode |
İsteğe bağlı. "en-US" veya "sr-Latn" gibi BCP-47 dil kodu. Daha fazla bilgi için Unicode Yerel Ayar Tanımlayıcısı bölümüne bakın. Desteklenen dillerin listesi için Dil Desteği sayfasına göz atın. Bu değeri sağlamadığınızda görüntüleme dili, ilk kaynağın konumuna göre belirlenir. |
regionCode |
İ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örüntülenen alanlar için ölçü birimlerini belirtir. |
extraComputations[] |
İsteğe bağlı. İsteği tamamlamak için kullanılabilecek ekstra hesaplamaların listesi. Not: Bu ekstra hesaplamalar yanıtta fazladan alanlar döndürebilir. Bu ek alanların, yanıtta döndürülmesi için alan maskesinde de belirtilmesi gerekir. |
trafficModel |
İsteğe bağlı. Trafikteki süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, |
transitPreferences |
İsteğe bağlı. |
Yanıt gövdesi
v2.computeRouteMatrix API'sinde bir başlangıç/hedef çifti için hesaplanan rota bilgilerini içerir. Bu proto, istemciye yayınlanabilir.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "status": { object ( |
Alanlar | |
---|---|
status |
Bu öğe için hata durum kodu. |
condition |
Rotanın bulunup bulunmadığını belirtir. Durumdan bağımsızdır. |
distanceMeters |
Rotanın metre cinsinden seyahat mesafesi. |
duration |
Rotada gezinmek için gereken süre. " |
staticDuration |
Trafik koşulları dikkate alınmadan rota boyunca seyahatin süresi. " |
travelAdvisory |
Rota hakkında ek bilgi. Örneğin: kısıtlama bilgileri ve geçiş ücreti bilgileri |
fallbackInfo |
Sunucunun söz konusu başlangıç/hedef çifti için verilen tercihlerle güzergahı hesaplayamadığı bazı durumlarda, farklı bir hesaplama modu kullanmaya geçebilir. Yedek modu kullanıldığında bu alan, yedek yanıtı hakkında ayrıntılı bilgiler içerir. Aksi takdirde bu alan ayarlanmaz. |
localizedValues |
|
originIndex |
İstekteki kaynağın sıfır tabanlı dizini. |
destinationIndex |
İstekteki hedefin sıfır tabanlı dizini. |
RouteMatrixOrigin
ComputeRouteMatrixRequest için tek bir kaynak
JSON gösterimi |
---|
{ "waypoint": { object ( |
Alanlar | |
---|---|
waypoint |
Zorunlu. Başlangıç noktası |
routeModifiers |
İsteğe bağlı. Bunu kaynak olarak alan her rota için değiştiriciler |
RouteMatrixDestination
ComputeRouteMatrixRequest için tek bir hedef
JSON gösterimi |
---|
{
"waypoint": {
object ( |
Alanlar | |
---|---|
waypoint |
Zorunlu. Varış noktası |
ExtraComputation
İstek tamamlanırken gerçekleştirilecek ekstra hesaplamalar.
Sıralamalar | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Kullanılmıyor. Bu değeri içeren istekler başarısız olur. |
TOLLS |
Matris öğeleri için ücret bilgileri. |
RouteMatrixElementCondition
Döndürülen rotanın durumu.
Sıralamalar | |
---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED |
Yalnızca öğenin status uygun olmadığında kullanılır. |
ROUTE_EXISTS |
Bir rota bulundu ve öğeye ilişkin bilgiler dolduruldu. |
ROUTE_NOT_FOUND |
Rota bulunamadı. distanceMeters veya duration gibi rota bilgilerini içeren alanlar öğede doldurulmaz. |
LocalizedValues
Belirli mülklerin metin temsilleri.
JSON gösterimi |
---|
{ "distance": { object ( |
Alanlar | |
---|---|
distance |
Metin biçiminde gösterilen seyahat mesafesi. |
duration |
Trafik koşulları dikkate alınarak metin biçiminde gösterilen süre. Not: Trafik bilgileri istenmediyse bu değer staticDuration ile aynı olur. |
staticDuration |
Trafik koşulları dikkate alınmadan metin biçiminde gösterilen süre. |
transitFare |
Toplu taşıma ücreti metin biçiminde gösterilir. |