Moving vehicle information

You can provide information about garbage trucks and snowplows through a feed. The appropriate vehicle (see above for illustrations) can then be presented both in the Waze map and the Live Map based on the listing details you provide. These listings won’t affect estimated times of arrival or navigation for car drivers who are using the Waze app.

Moving vehicle elements

Use the parameters in the following table to create a moving vehicle feed. This feed is a separate feed file from the incidents and road closure feed files.

Element Required? Tag input Description
truck Required Free text

A unique ID for each vehicle. It must be at least 3 alphanumeric characters in length.

<truck id="qV11DEayKr">...</truck>
location Required Lat lon

Latitude and longitude coordinates that describe the location of the vehicle. It should have at least 6 values after the decimal point for sufficient accuracy.

<location>40.510090 -110.006902</location>
status Required WORKING or NOT_WORKING

Whether or not the vehicle is in service.

<status>WORKING</status>
type Required GARBAGE or SNOW

The specific vehicle type.

<type>SNOW</type>
date Required yyyy-MM-dd'T'HH:mm:ss+HH:mm

The last update time of the vehicle in ISO8601 format, including the timezone offset. A value for seconds will be accepted but is not required.

<updatetime>
  2016-04-07T09:00:00+01:00
</updatetime>
heading Required azimuth

The vehicle heading direction in degrees. This is a positive integer between 0 and 359. (0 = North, 90 = East, and so on.)

<heading>120</heading>
speed_kmh Required unit

Identifies the vehicle speed in kilometers per hour. Value is a positive integer between 0 and 200.

<speed_kmh>32</speed_kmh>

Moving vehicle examples

The following examples show a single moving vehicle entry in both XML and JSON formats.

XML example

The following is an example of a single moving vehicle item in XML.

<truck id="45345345">
     <location>51.510090 -0.006902</location>
     <status>NOT_WORKING</status>
     <type>SNOW</type>
     <heading>50</heading>
     <speed_kmh>7</speed_kmh>
     <updatetime>2018-09-04-01T00:00:00-05:00</updatetime>
</truck>

JSON example

The following is an example of a single moving vehicle item in JSON.

{
  "id": "45345345",
  "location": "51.510090 -0.006902",
  "status": "NOT_WORKING",
  "type": "SNOW",
  "heading": "50",
  "speed_kmh": "7"
}

The following examples show an entire incident feed file in both XML and JSON formats.

XML feed file

The following is an example of a complete moving vehicle feed file using XML.

<trucks>
  <truck id="45345345">
     <location>51.510090 -0.006902</location>
     <status>NOT_WORKING</status>
     <type>SNOW</type>
     <heading>50</heading>
     <speed_kmh>7</speed_kmh>
     <updatetime>2018-09-04-01T00:00:00-05:00</updatetime>
  </truck>
  <truck id="545346">
     <location>50.310090 -0.006923</location>
     <status>WORKING</status>
     <type>SNOW</type>
     <heading>120</heading>
     <speed_kmh>32</speed_kmh>
     <updatetime>2018-07-30-01T00:00:00-05:00</updatetime>
  </truck>
  <truck id="345345567">
     <location>51.500090 -0.004702</location>
     <status>NOT_WORKING</status>
     <type>SNOW</type>
     <heading>120</heading>
     <speed_kmh>0</speed_kmh>
     <updatetime>2018-07-30-01T00:00:00-05:00</updatetime>
  </truck>
</trucks>

JSON feed file

The following is an example of a complete moving vehicle feed file using JSON.

{
   "trucks": [
      {
      "id": "45345345",
      "location": "51.510090 -0.006902",
      "status": "NOT_WORKING",
      "type": "SNOW",
      "heading": "50",
      "speed_kmh": "7"
      },
      {
      "id":"545346",
      "location": "50.310090 -0.006923",
      "status": "WORKING",
      "type": "SNOW",
      "heading": "120",
      "speed_kmh": "32"
      },
      {
      "id":"345345567",
      "location": "51.500090 -0.004702",
      "status": "NOT_WORKING",
      "type": "SNOW",
      "heading": "120",
      "speed_kmh": "0"
      }
   ]
}