ComputeRoutes()
yöntemini çağırdığınızda yanıtta döndürülmesini istediğiniz alanları belirtmeniz gerekir. Bunu, $fields
veya fields
URL parametresiyle sağladığınız bir yanıt alanı maskesi veya X-Goog-FieldMask
HTTP/gRPC başlığı kullanarak yapabilirsiniz. Daha fazla bilgi için Sistem Parametreleri bölümüne bakın.
Alan maskesi
Alan maskesi değeri, alan yollarının virgülle ayrılmış listesidir. Her alan yolu, mesaj hiyerarşisini temsil eden alan adlarının noktayla ayrılmış bir listesidir. Alan adı, JSON nesne anahtarı veya protobuf alan etiketinin adıdır. Alan yolu, üst düzey yanıt mesajı türünden başlar. İsteğe bağlı olarak ardından bir veya daha fazla nokta, ardından bir sonraki alan adı düzeyi gelir. Genel olarak, alan yolları aşağıdaki şekilde oluşturulur:
topLevelField[.secondLevelField][.thirdLevelField][...]
Özel durum alan maskesi, "*" joker karakteridir ve tüm kök düzeyindeki alanları seçer.
Ö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 çizgiyi gösteren alan maskesi (örnek üretim kurulumu).
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
Joker karakter (*) yanıt alan maskesinin kullanılmasını veya üretimde alan maskesinin üst düzeyde (yollar) belirtilmesini önermiyoruz. Sadece ihtiyacınız olan alanları seçin:
Sunucumuzun işlem döngülerini kaydetmesini sağlar. Böylece, sonuçlarınızı daha düşük bir gecikmeyle döndürebiliriz.
İstikrarlı gecikme performansı 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üzeyde tüm alanları seçerseniz, eklediğimiz yeni alanlar yanıtınıza otomatik olarak dahil edileceği için performansta düşüş yaşayabilirsiniz.
Daha küçük yanıt boyutuyla daha yüksek ağ işleme hızı elde edilir.
Alan yollarının nasıl oluşturulacağı hakkında daha fazla bilgi için field_mask.proto bölümüne bakın.