- HTTP isteği
- İstek metni
- Yanıt metni
- Yol
- Segment
- AnnotationOptions
- AnnotatedPath
- AnnotatedSegment
- SegmentSpanAttribute
- SegmentSpan
- LevelOfService
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 ( |
Alanlar | |
---|---|
paths[] |
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 |
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 ( |
Alanlar | |
---|---|
annotatedPaths[] |
İ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 ( |
Alanlar | |
---|---|
segments[] |
Zorunlu. Yolu oluşturan segmentlerin sıralı listesi. |
Segment
Bir yola ait segment.
JSON gösterimi |
---|
{ "polyline": { object ( |
Alanlar | |
---|---|
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 |
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 |
İ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 ( |
Alanlar | |
---|---|
annotatedSegments[] |
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 ( |
Alanlar | |
---|---|
segment |
Segmenti diğer segmentlerden ayırt etmek için kullanılan segment ayrıntıları. |
segmentSpanAttributes[] |
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 ( |
Alanlar | |
---|---|
segmentSpan |
Ek açıklamaların segmentin neresinde geçerli olduğunu açıklar. |
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 |
Aralığın başlangıcı, parçanın çoklu çizgisinin başlangıç noktasından ibarettir. |
endMeters |
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. |