Method: annotatePaths (Automotive)

Yollardaki dinamik özellikler için ek açıklamalarla birlikte segmente dayalı giriş yollarını geri döndürür.

HTTP isteği

POST https://routes.googleapis.com/annotations/v2:annotatePaths

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "paths": [
    {
      object (Path)
    }
  ],
  "annotationOptions": {
    object (AnnotationOptions)
  }
}
Alanlar
paths[]

object (Path)

Zorunlu. Dinamik özellik verileriyle doldurulması istenen rotalar. Tüm yollar, aynı başlangıç segmentine sahip olmalıdır. Bu, aracın şu anda bulunduğu segmenttir. Aracın ilk segmentin başında olduğu varsayılır. Yollar aynı segmentten başlamıyorsa hata döndürülür.
annotationOptions

object (AnnotationOptions)

Zorunlu. Giriş yollarına eklenmesi gereken istenen dinamik veri özellikleri. Boş bırakılırsa isteğe not eklenmez.

Yanıt gövdesi

AnnotatePathsResponse, istenen tüm ek açıklamalar için eklenen ek verilerle birlikte giriş yollarını içerir.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "annotatedPaths": [
    {
      object (AnnotatedPath)
    }
  ]
}
Alanlar
annotatedPaths[]

object (AnnotatedPath)

İstenen özelliklerle ek açıklamalı girişteki yollar.

Path

Dinamik özelliklerin istendiği bir yol.

Bir yolda, bağlı ve gidilebilir segmentler olmalıdır. Bir yolun segmentlerinin mantıksal bir rota izlediği varsayılır ve giriş segmentlerinde rota bulunamazsa hata döndürülür. Örneğin, bir yoldaki segmentlerin bağlantı uç noktaları yoksa veya bir yol boşsa hata oluşur.

Bir yolun uzunluğu şu anda 15 km ile sınırlıdır. Yol, ilk segmentin başlangıcından, yani aracın varsayılan konumuyla ölçülür. Bir yoldaki bir segment, ilk segmentin başlangıcından 15 km'den daha uzağa başlarsa hata döndürülür. Son segmentin 15 km'den önce başlayıp 15 km'den sonra bitmesi kabul edilebilir. Hiçbir kısmi yanıt döndürülmez.

Bir yol, başka bir yolla aynı segmentleri içerebilir ancak yolun diğer bölümlerindeki farklılıklara dayalı olarak segment ek açıklamalarının farklı yanıtlar içermesi de mümkündür.

JSON gösterimi 
{
  "segments": [
    {
      object (Segment)
    }
  ]
}
Alanlar
segments[]

object (Segment)

Zorunlu. Yolu oluşturan segmentlerin sıralı listesi.

Segment

Bir yola ait segment.

JSON gösterimi 
{
  "polyline": {
    object (Polyline)
  },

  // Union field id can be only one of the following:
  "placeId": string
  // End of list of possible types for union field id.
}
Alanlar
polyline

object (Polyline)

Zorunlu. Kimlik bulunamazsa segmenti tanımlamak ve aynı kimliğe sahip iki segmenti ayırt etmek için kullanılabilen segmentin çoklu çizgisi. Çoklu çizgi, standart Google Haritalar Platformu Kodlu Çoklu Çizgi Algoritma Biçimi kullanılarak kodlanır.
Birleştirme alanı id. Kimlik alanı içinde bu segmenti tanımlamak için kullanılır. Zorunlu. id şunlardan yalnızca biri olabilir:
placeId

string

Bu yol segmentinin yer kimliği. API'lerde kullanılır.

AnnotationOptions

Giriş yolları için istenen ek açıklamalar.

JSON gösterimi 
{
  "includeLevelOfService": boolean
}
Alanlar
includeLevelOfService

boolean

İsteğe bağlı. Doğru değerine ayarlandığında yanıttaki segmentlere tahmini trafik değerleriyle ek açıklama eklenir. "Level of Service", trafik akışının kategorilendirmesini tanımlamak için genellikle kullanılan bir terimdir ancak bu API'deki hizmet düzeyi tanımları yalnızca bu API'ye aittir.

AnnotatedPath

Tahmin edilen özelliklerle döndürülen bir giriş yolunun kopyası.

JSON gösterimi 
{
  "annotatedSegments": [
    {
      object (AnnotatedSegment)
    }
  ]
}
Alanlar
annotatedSegments[]

object (AnnotatedSegment)

Ana yolu oluşturan ve istenen özelliklerle ek açıklamalı olarak segmentlerin sıralı listesi.

AnnotatedSegment

Dinamik veri özellikleriyle ek açıklamalı, bir yol oluşturan segment.

JSON gösterimi 
{
  "segment": {
    object (Segment)
  },
  "segmentSpanAttributes": [
    {
      object (SegmentSpanAttribute)
    }
  ]
}
Alanlar
segment

object (Segment)

Segmenti diğer segmentlerden ayırt etmek için kullanılan segment ayrıntıları.
segmentSpanAttributes[]

object (SegmentSpanAttribute)

Segmente atanan özellikler. Bu özellikler segmentin bulunduğu yola göre farklılık gösterebilir. Bir aralık, segmentin tamamını kapsayabilir. Özellik aralıkları, araç konumundan yolun sonuna doğru sırayla yer alır.

SegmentSpanAttribute

SegmentSpanAttribute, API'den döndürülen ek açıklamaları içerir.

JSON gösterimi 
{
  "segmentSpan": {
    object (SegmentSpan)
  },
  "levelOfService": enum (LevelOfService)
}
Alanlar
segmentSpan

object (SegmentSpan)

Ek açıklamaların segmentin neresinde geçerli olduğunu açıklar.
levelOfService

enum (LevelOfService)

Araç segmentin başlangıcına vardığında bu segmentte beklenen trafik hızlarıyla tanımlanan, segment aralığı için tahmini trafik düzeyi.

SegmentSpan

Bir segmentin alt bölümünü sınırlamak için kullanılır. Bir aralık segmentin tamamını kapsıyorsa başlangıç Ölçüm Aracı 0, bitişMetre ise segment uzunluğu olur.

JSON gösterimi 
{
  "startMeters": integer,
  "endMeters": integer
}
Alanlar
startMeters

integer

Aralığın başlangıcı, parçanın çoklu çizgisinin başlangıç noktasından ibarettir.
endMeters

integer

Aralığın bitişinin, segmentin çoklu çizgisinin başlangıç noktasından olduğu yerdir.

LevelOfService

ADAS işlevinde kullanılacak ve genel trafik düzeyleriyle eşlenen tahmini trafik grubu değerleri. Bu API tarafından döndürülen değerler bağımsızdır ve diğer API'lere karşılık gelen değerler kullanılmamalıdır.

Sıralamalar
LEVEL_OF_SERVICE_UNSPECIFIED Varsayılan değer. Bu değer, tahmini trafik değerinin mevcut olmadığı anlamına gelir.
LEVEL_OF_SERVICE_STOPPED Trafik durduruldu.
LEVEL_OF_SERVICE_STOP_AND_GO Trafik dur-kalk şeklinde.
LEVEL_OF_SERVICE_SLOW Yavaşlama bekleniyor ancak trafik sıkışıklığı beklenmiyor.
LEVEL_OF_SERVICE_NORMAL Normal hız, yavaşlama beklenmiyor.