Paylaşımlı yolculuk için en iyi rotayı belirlerken en hızlı rota her zaman en iyi seçenek olmayabilir. Rotanızı planlamak isteyebilirsiniz.
Routes Preferred API, ComputeCustomRoutes yöntemini kullanarak bir rota hedefi belirterek rota planlamanıza olanak tanır.
ComputeCustomRoutes yöntemi, operatör tarafından seçilen rota ile gidilen rota arasındaki farkı en aza indirmenize olanak tanıyarak rotaya uyumluluğu sağlamanıza da yardımcı olabilir.
Rota planlamanın tüm avantajlarından yararlanmak için hem Routes Preferred API'yi hem de Navigation SDK'yı kullanın.
ComputeCustomRoutes yöntemini etkinleştirme
Kodunuzda ComputeCustomRoutes yöntemini kullanabilmek için önce bu yöntemi etkinleştirmeniz gerekir. Routes Preferred API yöntemlerini etkinleştirme hakkında daha fazla bilgi için Başlangıç bölümüne bakın.
ComputeCustomRoutes yöntemini kullanma
ComputeCustomRoutes yöntemi, 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. Daha fazla bilgi için Sistem Parametreleri başlıklı makaleyi inceleyin.
Alan maskesi değeri, virgülle ayrılmış alan yolları listesidir. Her alan yolu, ileti hiyerarşisini temsil eden alan adlarının nokta ile ayrılmış bir listesidir. Alan adı, JSON nesnesi anahtarı veya protobuf alan etiketi adıdır. Alan yolu, üst düzey yanıt mesajı türüyle başlar, isteğe bağlı olarak bir veya daha fazla nokta ve ardından bir sonraki düzeydeki alan adıyla devam eder. Genel olarak alan yolları aşağıdaki şekilde oluşturulur:
topLevelField[.secondLevelField][.thirdLevelField][...]
Özel durum alan maskesi, tüm kök düzeyindeki alanları seçen bir joker karakter olan "*"dır.
Daha fazla bilgi için aşağıdaki sayfaları inceleyin:
ComputeCustomRoutes yönteminin kullanımına ilişkin örnekler için Özel Rota Hesaplama (Beta) Örnekleri başlıklı makaleyi inceleyin.
Geçiş ücretlerini hesaplama
Geçiş ücretlerinin hesaplanması hakkında bilgi için Geçiş ücretlerini hesaplama başlıklı makaleyi inceleyin.
Geçiş ücretlerinin hesaplanmasıyla ilgili örnekler için Özel Rota Hesaplama Örnekleri başlıklı makaleyi inceleyin.