Yêu cầu cầu vượt và đường hẹp

Routes API có thể trả về thông tin về các tính năng tuyến đường sau đây (nếu có):

  • Cầu vượt: Thông tin về các đoạn đường nâng cao, chẳng hạn như cầu vượt và cầu.
  • Đường hẹp: Thông tin về những con đường được coi là hẹp hơn bình thường.

Không có chỉ báo trực quan nào được cung cấp trên bản đồ.

Quốc gia được hỗ trợ: Chỉ Ấn Độ

Lý do sử dụng

Sử dụng các tuỳ chọn đường bay và đường hẹp để thông báo cho người dùng về các tính năng này. Ví dụ: cung cấp cảnh báo hoặc chỉ báo trực quan trên bản đồ để người lái xe sử dụng ứng dụng của bạn có thể dễ dàng dự đoán những tuyến đường này và điều chỉnh cách lái xe cho phù hợp.

Để biết hướng dẫn, hãy xem các phần sau:

Yêu cầu thông tin về đường bay

Yêu cầu của bạn phải đáp ứng các tiêu chí sau:

  • Yêu cầu một tuyến đường ở Ấn Độ.
  • Đặt travelMode thành DRIVE hoặc TWO-WHEELER.
  • Bao gồm "extraComputations": ["FLYOVER_INFO_ON_POLYLINE"].
  • Thêm mặt nạ trường cho các trường sau:
    • routes.polyline_details.flyover_info
    • routes.polyline
  • Không đưa tham số optimizeWaypointOrder vào.

Để biết thông tin chi tiết, hãy xem PolylineDetails.FlyoverInfo.

Yêu cầu mẫu: Thông tin về đường bay trên cao

curl -X POST -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 28.57580734159006,
        "longitude": 77.02719067373043
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 28.595737365438477,
        "longitude": 77.16870453065245
      }
    }
  },
  "travelMode": "DRIVE",
  "extraComputations": ["FLYOVER_INFO_ON_POLYLINE"]
}\
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.polyline_details.flyover,routes.polyline' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Ví dụ về phản hồi: Thông tin về đường bay trên cao

{
  "routes": [{
    "polyline": {
      "encodedPolyline": "selmD}jcuM?oBcDAqEF}DCOOZuCfAwJFMJM\\_Cd@mEv@gFHQF_C?eIGe@_@{@g@u@MY@Wz@cCp@}AF_@MeC?kLFy@xZpBxRlAdJj@zCPlBRxPfApP|@`@MVUHQv@iF~@aFfAeEnA_EpAgD`@kAjCeF~FiKPa@NOx@iApAyCtA{C`@wAEg@Ba@Xq@TU`@MZCLY^QPQx@kAn@cAh@s@^YZ]fA{@lAs@bBy@`DiAtDwAdB_ARCP@z@m@dAeAbA_BpAcCd@oAr@eBRe@nEsIjAiBdAuBZw@n@{BTsANi@p@wAJ]h@wCr@oEr@yEvAwI`AuGt@gG`@oEt@wFr@}FpB_N`CiQ`AqGVoAbEcP^_Br@uDr@yEPqA^cEj@iERyCReEf@}GvBkQXwATgC@_@AYK]u@wAGa@IoHFaEFoAXuDVqBdBsLb@qDRuCRaELu@Rs@d@u@lBaC\\o@Tm@VwANcAHmADuCCsAKo@YkAU}@AQ@WHa@iJyTs@uAe@q@c@i@oA_AuAw@kBu@iEwAuDoA_JeDiB}@qAaA]a@u@gAeAoB_CoG}@eCgAoCw@wAsByCe@i@iCmDmAmB}BeDu@aAaHyJ_BwBCEyBaD}AkBu@u@uAy@gBw@yAc@gFoAiKmC}E{@eCk@sF}@YCwDIqDG{Tq@mB@_Ne@k@AoBGkAKaB]{Am@gBkAcAgAcBeCmAwBwAwCmDeGq@yAcAwCmCgJQu@i@gAw@mAaAkA{@u@oAu@eAe@kAa@}GcBEAkDq@aAWkKaBqDq@oMuBuBc@e@Ok@Wm@e@_AaAm@aA[}@a@uAy@aDmCmJSi@cAmDsEyNgAaDcDeKEo@gAkDkD{I_AyCg@qBeAqEU_AgA_D[{@gBoGaDaIqDaIYs@"
    },
    "polylineDetails": {
      "flyoverInfo": [{
        "flyoverPresence": "EXISTS",
        "polylinePointIndex": {
          "startIndex": 153,
          "endIndex": 173
        }
      }, {
        "flyoverPresence": "EXISTS",
        "polylinePointIndex": {
          "startIndex": 190,
          "endIndex": 213
        }
      }]
    }
  }]
}

Yêu cầu cung cấp thông tin về đường hẹp

Yêu cầu của bạn phải đáp ứng các tiêu chí sau:

  • Yêu cầu tuyến đường ở Ấn Độ
  • Đặt travelMode thành DRIVE.
  • Đã tính "extraComputations": ["NARROW_ROAD_INFO_ON_POLYLINE"]

  • Thêm mặt nạ trường cho các trường sau:

    • routes.polyline_details.narrow_road_info
    • routes.polyline.

  • Không đưa tham số optimizeWaypointOrder vào.

Để biết thông tin chi tiết, hãy xem PolylineDetails.NarrowRoadInfo.

Yêu cầu mẫu: Thông tin về đường hẹp

curl -X POST -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 12.9598336,
        "longitude": 80.1659834
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 12.9593739,
        "longitude": 80.1723585
      }
    }
  },
  "travelMode": "DRIVE",
  "extraComputations": ["NARROW_ROAD_INFO_ON_POLYLINE"]
}\
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: `routes.polyline_details.narrow_road_info`,routes.polyline' \
'[https://routes.googleapis.com/directions/v2:computeRoutes](https://routes.googleapis.com/directions/v2:computeRoutes)'

Ví dụ về câu trả lời: Đường hẹp

{
  "routes": [{
    "polyline": {
      "encodedPolyline": "{ebnA_mhhNqAGGeD?aAFq@Xy@Re@Jm@FmABOHOTQBYWgIBiHBo@j@@d@@"
    },
    "polylineDetails": {
      "narrowRoadInfo": [{
        "narrowRoadPresence": "EXISTS",
        "polylinePointIndex": {
          "startIndex": 15,
          "endIndex": 16
        }
      }]
    }
  }]
}

Khu vực được hỗ trợ

Cầu vượt và đường hẹp chỉ được hỗ trợ ở Ấn Độ.

Thanh toán

Nền tảng Google Maps không tính thêm phí khi bạn sử dụng tính năng thử nghiệm. Bạn sẽ bị tính phí dựa trên mức sử dụng API dựa trên các tham số khác mà bạn đặt.

Tìm hiểu thêm về cách thanh toán cho Routes API.