Güzergah Matrisi hesaplayın

Bu ürün veya özellik önizleme aşamasındadır (GKST öncesi). GKST öncesi ürünlere ve özelliklere verilen destek sınırlı olabilir ve özellikleri, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmetine Özel Şartlar. Daha fazla bilgi için lansman aşaması açıklamaları bölümüne gidin.

Bir rotanın mesafesini ve süresini birden fazla metrik için hesaplayabilirsiniz. ComputeRouteMatrix yöntemini kullanarak kalkış ve varış noktaları Routes Preferred API'si hakkında daha fazla bilgi edinin. ComputeRouteMatrix destekler hem akışlı gRPC çağrıları hem de REST HTTP çağrılarına karşılık gelir.

Kalkış ve hedef çiftleri listesi verildiğinde, ComputeRouteMatrix her kalkış noktasında başlayan bir rotanın mesafesini ve süresini hesaplar ve her bir hedefte sona erer. Akışın her öğesi karşılık gelir tek bir rotayla ilgili bilgi sağlar.

ComputeRouteMatrix yönteminin, Mesafe Matrisi Hizmeti:

• Akış, matrisin tamamından önce öğelerin döndürülmesini sağlar hesaplanarak gecikmeyi azaltır.
• ComputeRouteMatrix, trafik hesaplaması için ayrıntılı seçenekler sunar. Böylece kalite-gecikmeden ödün vermeden
• İstekler Google'ın altyapısında daha yüksek öncelikte çalıştırılır. bu da daha yüksek kullanılabilirlik sağlar.
• Yön (seyahat yönü) ve yan yol belirtebilirsiniz bilgileri inceleyin.
• Aşağıdaki bilgilerle birlikte ücretli geçiş bilgilerinin sağlanmasını isteyebilirsiniz: ve TVS’yi gösterir.

ComputeRouteMatrix yöntemini etkinleştir

Kodunuzda ComputeRouteMatrix yöntemini kullanmadan önce etkinleştireceğim. Routes Preferred API'yi etkinleştirme hakkında daha fazla bilgi için yöntemleri için Başlarken bölümüne bakın.

Önemli: Routes Preferred API için kota sınırlarınızı kontrol edin yöntemlerine göz atın. Kota sınırlarınızı artırmanız gerekirse Google Haritalar Platformu destek sayfasındaki destek kaydı veya Google Cloud Destek Hattı.

ComputeRouteMatrix yöntemini kullanma

ComputeRouteMatrix yöntemi, Tercih Edilen Rotalar üzerinden kullanılabilir v1 uç noktası.

Daha ayrıntılı bilgi için aşağıdaki dokümanlara göz atın:

gRPC: https://developers.google.com/maps/documentation/routes_preferred/reference/rpc/google.maps.routes.v1

REST: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeRouteMatrix

Aşağıdaki genel adımlarda, ComputeRouteMatrix yöntemi:

1. Googleapis deposundaki gerekli proto arabelleklere göz atın:

   https://github.com/googleapis/googleapis/tree/master/google/maps/routes

   Go gibi bazı derleme sistemlerinin bunu sizin için otomatik olarak yapabileceğini unutmayın.

2. Tercih ettiğiniz dili ve geliştirme araçları setini kullanarak alakalı bir kod yazın.

3. İsteğinizi oluşturun. İki gerekli meta veri gönderilmelidir istekle ilgili olarak:

   • X-Goog-Api-Key, API anahtarınız olarak ayarlanmalıdır.

   • X-Goog-Fieldmask, alanların virgülle ayrılmış bir listesine ayarlanmalıdır önemli olabilir. Örneğin, X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status. Tüm alanları belirtmek için joker karakter (*) kullanabilirsiniz ancak bu, daha fazla sonuç alırsınız. API yanıtı ama alan maskesinde istediğiniz alanları açıkça listeleyin kontrol edebilirsiniz.

     Alan maskesi dizesinin nasıl oluşturulacağıyla ilgili daha fazla bilgi için https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto. İhtiyacınız olmayan alanları devre dışı bırakmanın, bu alanlarda daha fazla hesaplama gerekebilir. Gecikme süreniz aynı kalacak ve yalnızca iki renk gerektiren yeni alanları belirtirseniz, daha fazla hesaplama işlemi eklenir.

4. İsteğinizi routespreferred.googleapis.com:443 adresine gönderin.Şunu kullanmanız gerekir: TLS protokolüdür.

ComputeRouteMatrix yöntemini kullanma örnekleri için Rota Matrisi (Beta) Örneklerini Hesaplama.

ComputeRouteMatrix yönteminin ayırt edici bir özelliği, hata kodları tüm akışın tamamı veya tek tek kullanıcılar için döndürülebilir öğeler. Örneğin, akış bağlantısı hatalı biçimlendirilmiş (örneğin, sıfır kaynağı varsa). Ancak bir hata geçerliyse (örneğin, geçersiz bir Yer Kimliği ayarlamak) bir kaynak içeriyorsa) yalnızca hatadan etkilenen öğeler hata kodlarını içerir.

Akış tarafından döndürülen öğelerin döndürüleceği garanti edilmez herhangi bir sırada. Bu nedenle, her öğe bir origin_index içerir. ve destination_index. Belirtilen kalkış noktaları ve hedefler için istek üzerine, rota kaynağı origins[origin_index] ile eşdeğerdir rota hedefi eşdeğerse Hedef: destinations[destination_index]. Bu diziler sıfır dizine sahiptir. Google Kalkış ve hedef listelerindeki siparişlerin depolanması önemlidir.

Geçiş ücretleri hesaplanıyor

Geçiş ücretlerini hesaplama hakkında bilgi edinmek için bkz. Geçiş ücretlerini hesaplayın.

Geçiş ücretlerini hesaplama örnekleri için bkz. Güzergah Matrisi Örneklerini Hesaplama.