Custom Route Extension API Developer's Guide

Submit an Overlay

The user wants to create an overlay to modify parts of the road network, particularly close to the Alte Bruecke in Frankfurt, Germany and insert a new bridge to its West. This new bridge is limited to 3.3 tons.

Request

The request

 GET http://cre.cit.api.here.com/2/overlays/upload.json
?map_name=OVERLAYEXAMPLE1
&overlay_spec=[
  { "op":"override",
  "shape":[[50.10765,8.68774],[50.10914,8.68771]],
  "layer":"LINK_ATTRIBUTE_FCN",
  "data":{"VEHICLE_TYPES":"0"}
  },
  { "op":"create",
  "shape":[[50.10937,8.68422],[50.10807,8.68525],[50.10737,8.68387]],
  "data":{"NAMES":"ENGBNDemo Road"}
  },
  { "op":"override",
  "shape":[[50.10937,8.68422],[50.10807,8.68525],[50.10737,8.68387]],
  "layer":"TRUCK_RESTR_FCN",
  "data":{"VEHICLE_TYPES":"truck", "WEIGHT_RESTRICTION":"3300"}
  }
]
&storage=readonly
&app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}

Response

The response confirms a successful overlay map upload with the 201 Created response code. Within a short time, the map is available for routing.
{
  "layers": [
  "LINK_ATTRIBUTE_FC2",
  "LINK_FC5",
  "LINK_FC3",
  "LINK_FC2",
  "LINK_ATTRIBUTE_FC3",
  "ROAD_ADMIN_FC5",
  "ROAD_ADMIN_FC2",
  "ROAD_GEOM_FC5",
  "ROAD_ADMIN_FC3",
  "LINK_ATTRIBUTE_FC5",
  "ROAD_GEOM_FC2",
  "ROAD_GEOM_FC3"
  ],
  "response_code": "201 Created"
}