ComputeRoutes() yöntemini çağırdığınızda, eklemek istediğiniz
yanıtta döndürülmesini isteyin. Bunu, yanıt alanı maskesi yardımıyla yapabilirsiniz.
$fields veya fields URL parametresini sağlayın ya da
HTTP/gRPC başlığı X-Goog-FieldMask. Daha fazla bilgi için Sistem Parametreleri başlıklı makaleyi inceleyin.
Alan maskesi
Alan maskesi değeri, alan yollarının virgülle ayrılmış bir listesidir. Her bir alan yolu ileti hiyerarşisini temsil eden alan adlarının noktayla ayrılmış bir listesidir. CEVAP alan adı JSON nesne anahtarı veya protobuf alan etiketi adıdır. Alan yolu, üst düzey yanıt mesajı türünden başlar ve isteğe bağlı olarak bir veya daha fazla nokta ve ardından bir sonraki düzey alan adından oluşur. Genel olarak alan yolları aşağıdaki şekilde oluşturulur:
topLevelField[.secondLevelField][.thirdLevelField][...]
Özel durum alan maskesi, tüm kök düzeylerini seçen bir "*" joker karakteridir. alanları.
Örnekler
Aşağıdaki örnekte, ComputeRoutes() yöntemi için alan maskelerinin nasıl ayarlanacağı gösterilmektedir.
1. Örnek
Mevcut tüm alanların alan maskesi (manuel inceleme için).
X-Goog-FieldMask: *
2. Örnek
Rota düzeyinde süre, mesafe ve çoklu çizgi için alan maskesi (örnek üretim kurulumu).
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
Üretimde joker karakter (*) yanıt alanı maskesinin kullanılmasından veya alan maskesinin üst düzeyde (rotalar) belirtilmesinden kaçınılmasını öneririz. Yalnızca aşağıdaki alanları doldurmanız gerekir:
Sunucumuzun, işlem döngülerini kaydetmesini sağlar. Bu da size daha düşük gecikmeli sonuçlar elde edersiniz.
İstikrarlı gecikme performansı sağlar. Daha fazla yanıt alanı eklemek için ve bu yeni alanlar daha fazla hesaplama süresi gerektirebilir. Seçim tüm alanları seçerseniz üst düzeydeki tüm alanları seçerseniz performans düşüşü, çünkü eklediğimiz yeni alanlar otomatik olarak yanıtınıza dahil edilmiş olabilir.
Yanıt boyutu daha küçük olur ve bu da daha büyük bir ağa dönüşür. işleme hızı.
Alan yollarının nasıl oluşturulacağı hakkında daha fazla bilgi için field_mask.proto dosyasını inceleyin.