İade edilecek bilgileri seçme

Bir rota veya rota matrisini hesaplamak için bir yöntem çağırdığınızda, yanıtta döndürülecek alanları listeleyerek hangi bilgileri istediğinizi belirtmeniz gerekir. Döndürülen alanların varsayılan listesi yoktur. Bu listeyi atlarsanız yöntemler hata döndürür.

Yanıt alanı maskesi oluşturarak alan listesini belirtirsiniz. Ardından, yanıt alanı maskesini $fields veya fields URL parametresini ya da HTTP veya gRPC başlığını X-Goog-FieldMask kullanarak yöntemlerden birine iletirsiniz.

Gereksiz veriler istememek için alan maskesi kullanmak iyi bir tasarım uygulamasıdır. Bu da gereksiz işlem süresinden ve faturalandırılan ücretlerden kaçınmanıza yardımcı olur.

URL parametreleri hakkında daha fazla bilgi için Sistem Parametreleri bölümüne bakın.

Yanıt alanı maskesi tanımlama

Yanıt alanı maskesi, her yolun yanıt mesajında benzersiz bir alan belirttiği, virgülle ayrılmış bir yol listesidir. Yol, üst düzey yanıt mesajından başlar ve belirtilen alana noktayla ayrılmış bir yol kullanır.

Aşağıdaki gibi bir alan yolu oluşturup belirtin:

  1. Routes API'den ihtiyacınız olan bilgileri içeren alanları bulun. Ayrıntılar için Alan Referansları bölümüne bakın.
  2. İhtiyacınız olan alanların yollarını belirleyin ve bunlar için alan maskelerini oluşturun: Ayrıntılar için Kullanmak istediğiniz alan maskesini belirleme başlıklı makaleyi inceleyin.

  3. Alan maskelerini virgülle ayırarak ihtiyacınız olan tüm alanların alan maskelerini birleştirin. Örneğin, rota adımı için distanceMeters'yi ve her rota adımı adımının süresini istemek üzere her ikisini de virgülle ayırarak ve boşluk bırakmadan girin:

    routes.legs.distanceMeters,routes.legs.steps.duration

  4. Alan maskesini API isteğinizle birlikte gönderin. Örneğin, bir cURL isteğinde alan maskesini -H ve X-Goog-FieldMask ile belirtirsiniz:

    -H X-Goog-FieldMask: routes.legs.distanceMeters,routes.legs.steps.duration
Örnekler ve daha fazla ayrıntı için aşağıdaki bölümlere bakın.

Alan Referansları

Alan maskeleri aracılığıyla bir yanıtta isteyebileceğiniz alanları görmek için aşağıdaki listede bağlantısı verilen Routes API referanslarına bakın. Alanları referanstaki gibi büyük/küçük harf kullanmadan belirtin. Örneğin, routePreference.

Bu referanslar, kullanılabilir alanları içerir. Ancak tam alan maskesi yolunu belirlemek için alanların hiyerarşisini referans olarak kullanmanız gerekir. Alanların hiyerarşisini alma hakkında ayrıntılı bilgi için Kullanmak istediğiniz alan maskesini belirleme başlıklı makaleyi inceleyin.

  • Compute rota alanı maskesi
    • REST: Yanıtta döndürülecek Route nesnesinin alanlarını belirtir. Bu alanların önüne routes. ön eki eklenir (ör. routes.distanceMeters).
    • gRPC: Döndürülecek yanıttaki Route nesnesinin alanlarını belirtir.
  • Rota matrisi alan maskelerini hesaplama

Hangi alan maskelerinin kullanılacağını belirleme

Kullanmak istediğiniz alanları nasıl belirleyeceğiniz ve bunlar için alan maskelerini nasıl oluşturacağınız aşağıda açıklanmıştır:

  1. * alan maskesini kullanarak tüm alanları isteyin.
  2. İstediğiniz alanlar için yanıtta alanların hiyerarşisine bakın.

  3. Önceki adımda gösterilen alanların hiyerarşisini kullanarak aşağıdaki biçimi kullanarak alan maskelerinizi oluşturun:

    topLevelField[.secondLevelField][.thirdLevelField][...]

Örneğin, bir rotadan alınan bu kısmi yanıt için:

"routes": [
    {
        "legs": [
            {  "steps": [
                    {"distanceMeters": 119},
                    {"distanceMeters": 41}  ]
            }
        ],
        "distanceMeters": 160
    }
]

Rota adımı için yalnızca distanceMeters alanını (yani önceki örnekteki son distanceMeters alanını) döndürmek istiyorsanız alan maskeniz aşağıdaki gibidir:

routes.legs.distanceMeters

Bunun yerine, rota adımını her adımı için distanceMeters alanını döndürmek istiyorsanız (yani önceki örnekte steps altındaki distanceMeters) alan maskeniz aşağıdaki gibidir:

routes.legs.steps.distanceMeters

Yukarıdaki sonuçla birlikte ikisini de döndürmek istiyorsanız alan maskenizin değeri şöyledir:

routes.legs.distanceMeters,routes.legs.steps.distanceMeters

Örnek alan maskesi yolları

Bu bölümde, REST ve gRPC çağrılarında bir yanıt alanı maskesinin parçası olarak alan yolunun nasıl belirtileceğine dair daha fazla örnek verilmiştir.

computeRoutes için REST çağrısı

İlk örnekte, bir rota hesaplamak için computeRoutes yöntemine bir REST çağrısı gönderirsiniz. Bu örnekte, yanıtta distanceMeters ve duration yol alanlarının döndürülmesi için üstbilgide alan maskeleri belirtirsiniz. Alan adının önüne routes eklemeyi unutmayın.

X-Goog-FieldMask: routes.distanceMeters,routes.duration

computeRouteMatrix için REST çağrısı

Bir rota matrisini hesaplamak için kullanılan REST computeRouteMatrix yöntemi için başlıkta, her bir kaynak ve hedef kombinasyonu için originIndex, destinationIndex ve duration döndürüleceğini belirtin:

X-Goog-FieldMask: originIndex,destinationIndex,duration

gRPC çağrısı

gRPC için yanıt alanı maskesini içeren bir değişken ayarlayın. Ardından bu değişkeni isteğe iletebilirsiniz.

const (
  fieldMask = "routes.distanceMeters,routes.duration,routes.polyline.encodedPolyline"
)

Alan yoluyla dikkat edilmesi gereken noktalar

Yalnızca ihtiyacınız olan alanları döndürmek için yanıta yalnızca ihtiyacınız olan alanları ekleyin:

  • İşleme sürelerini kısaltır. Böylece sonuçlarınız daha düşük gecikmeyle döndürülür.
  • Sabit gecikme performansı sağlar. Tüm alanları veya üst düzeydeki tüm alanları seçerseniz yeni alanlar eklenip yanıtınıza otomatik olarak dahil edildiğinde performansta düşüş yaşayabilirsiniz.
  • Daha küçük bir yanıt boyutuna neden olur. Bu da daha yüksek ağ işleme hızına dönüşür.
  • Gereksiz veri istememenizi sağlar. Bu da gereksiz işlem süresini ve faturalandırılan ücretleri önlemeye yardımcı olur.

Alan maskesi oluşturma hakkında daha fazla bilgi için field_mask.proto dosyasını inceleyin.

Rota jetonu isteme

Routes API'nin oluşturulan rotalar için rota jetonları döndürmesini istemek üzere aşağıdaki adımları uygulayın:

  1. Rota jetonu döndürmek için gereken aşağıdaki parametreleri ayarlayın:
    • travelMode değerini DRIVE olarak ayarlayın.
    • routingPreference öğesini TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL olarak ayarlayın.
  2. Rotadaki yol işaretçilerinizin hiçbirinin via yol işaretçisi olmadığından emin olun.
  3. Rota jetonu döndürmek için routes.routeToken alan maskesini belirtin: 
    X-Goog-FieldMask: routes.routeToken

Navigasyon SDK'sında planlanmış rotanız için rota jetonunu kullanabilirsiniz. Daha fazla bilgi için Rota planlama (Android) veya Rota planlama (iOS) başlıklı makaleyi inceleyin.

Rota jetonu örneği

Tek bir kaynak ve tek bir hedefe sahip rota için örnek bir cURL istek gövdesi aşağıda verilmiştir. Bu örnekte, rota jetonu istemek için alan maskeleri, rota süresi, mesafe ve rota poli çizgisi kullanılmaktadır:

curl -X POST -d
{"origin":{
    "location": {
        "latLng":{
            "latitude":  -37.8167,
            "longitude": 144.9619
        }
    }
},
"destination":{
    "location": {
        "latLng":{
            "latitude":-37.8155,
            "longitude": 144.9663
        }
    }
},
"routingPreference":"TRAFFIC_AWARE",
"travelMode":"DRIVE"
}
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H X-Goog-FieldMask: routes.routeToken,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
'https://routes.googleapis.com/directions/v2:computeRoutes'

Daha fazla bilgi için Compute Routes API referansı başlıklı makaleyi inceleyin.