BeMapAPI
BeMap 4.1.0

Traffic Get live traffic

BeMap name: Traffic

POST/traffic/1.0

The traffic events and conditions of a country or an area, to warn drivers or plan around them.

The whole description

In BeMap's words

To get the traffic information by country or an restricted area.

To get the traffic information by country or an restricted area.

Provisioned per account. This service is enabled per account; without it BeMap answers 400 with Access Denied.

Request body

JSON, Content-Type: application/json. Schema TrafficRequest.

  • geoserverstring

    Geoserver name.

  • swidxinteger (int32)deprecated

    Switch index.

  • countryCodestring

    Country ISO Code. Performs a data extract operation inside the specified Iso code filter.

  • timestampinteger (int64)

    Time stamp in milliseconds.

  • boundingBoxBoundingBox

    The bounding box make a filter on an specific area.

    BoundingBox fields
    • minLonnumber (double)

      Minimum longitude, in degrees decimal (WGS84).

    • minLatnumber (double)

      Minimum latitude, in degrees decimal (WGS84).

    • maxLonnumber (double)

      Maximum longitude, in degrees decimal (WGS84).

    • maxLatnumber (double)

      Maximum latitude, in degrees decimal (WGS84).

  • elementIdstring

    Traffic element ID.

  • reverseDirectionboolean

    Define the side of road will be used.

  • optionsenum[]

    Options of traffic info service.

    9 accepted values
    STATSEnable the data outputs like jam factor, speed and other information.
    POLYLINEEnable the polyline geometry output.
    SYNC
    ALERTCEnable the Alert-C outputs.
    OPENLREnable the OpenLR outputs.
    TRAFFIC_PREDICTIVEEnable the predictive traffic information.
    TRAFFIC_HISTORICAL(Beta) Enable the historical traffic information.
    ONLY_BLOCKED_ROADTo get only the blocked roads (closed).
    EXCLUDE_BLOCKED_ROADTo exclude all blocked roads (closed).
  • previousUpdateTimestampinteger (int64)deprecated

    The previous time stamp of update, can be used for synchronization mode.

  • outputLanguagestring

    Output language.

Response

200, schema TrafficResponse.

Response fields
  • countryInitializedboolean

    Country initialized.

  • trafficResponseElementsTrafficRespElement[]

    Traffic response elements.

    TrafficRespElement fields
    • trafficItemTrafficItem

      Traffic Item.

      TrafficItem fields
      • infoTrafficElementInfo

        Traffic information of element.

        TrafficElementInfo fields
        • idstring
        • countryCodestring
        • copyrightstring
        • releaseDatestring (date-time)
        • lastUpdateDatestring (date-time)
      • elementIdstring

        Element ID.

      • reverseDirectionboolean

        True for inverse road direction.

      • boundingBoxBoundingBox

        Bounding box of geometry in WGS84.

        BoundingBox fields
        • minLonnumber (double)

          Minimum longitude, in degrees decimal (WGS84).

        • minLatnumber (double)

          Minimum latitude, in degrees decimal (WGS84).

        • maxLonnumber (double)

          Maximum longitude, in degrees decimal (WGS84).

        • maxLatnumber (double)

          Maximum latitude, in degrees decimal (WGS84).

      • jamFactornumber (float)

        Percent (%) of traffic jam. Between 0.00 (free way) to 100.00 (full jam).

      • reasonenum

        TrafficReason.

        10 accepted values
        NANot available.
        CONGESTIONtraffic congestion (jam).
        CARRIAGEWAY_REDUCEDCarriage-way reduced.
        ACCIDENTAccident.
        INCIDENTIncident.
        INFORMATIONInformation.
        NON_RECOMMANDED_ROADNon re-commanded road.
        ROAD_CONDITION_DETERIORATEDRoad condition deteriorated.
        BLOCKED_ROADBlocked road.
        ROAD_UNDER_CONTRUCTIONRoad under construction.
      • reasonCommentsTrafficResComment[]

        List of reason comments.

        TrafficResComment fields
        • languagestring
        • commentstring
      • reasonCoordinateCoordinate

        Coordinate of the reason event.

        Coordinate fields
        • lonnumber (double)required

          Longitude in degrees decimal (WGS84).

          Also accepted as longitude.

        • latnumber (double)required

          Latitude in degrees decimal (WGS84).

          Also accepted as latitude.

      • polylineCoordinate[]

        Polyline.

        Coordinate fields
        • lonnumber (double)required

          Longitude in degrees decimal (WGS84).

          Also accepted as longitude.

        • latnumber (double)required

          Latitude in degrees decimal (WGS84).

          Also accepted as latitude.

      • segmentInfosTrafficSegInfo[]

        Segment Info.

        TrafficSegInfo fields
        • idstring

          Unique identifier of road segment.

        • reverseDirectionboolean

          The route travel is in opposite way of geometry.

      • tmcInternalIdinteger (int64)

        AlertcTrafficElement.

      • alertcEbuCountryCodestring

        AlertcTrafficElement.

      • alertcTableIdinteger (int64)

        AlertcTrafficElement.

      • alertcLocationIdinteger (int64)

        AlertcTrafficElement.

      • alertcExtendinteger (int32)

        AlertcTrafficElement.

      • alertcCodeinteger (int32)

        AlertcTrafficElement.

      • openLrBase64string

        OpenLrTrafficElement.

Errors

  • 400 Bad Request, ErrorResponse
  • 302 No credentials were sent. Do not follow the redirect.
  • 401 The account or the API key is wrong.

How to read each one: Errors.

Reference pages