How to create an ODD with an API
You can use multiple HERE APIs to edit and update ODD maps in ADZ. For this example, we use the HERE DATA API.
Authenticate
To use a HERE API, you must first obtain an OAuth token.
Construct a payload message
Once authenticated, you can construct your ADZ request using the ADZ schema.
| Parameter | Description |
|---|---|
"target" | The state layer you wish to update, such as proposed. |
"type" | The selection type used on the segment, such as direct selection, admin area, or polgon. For more information, see Map filters and selection methods |
"from" and "to" | The portion of the segment you wish to update. from and to set to 0 and 100, respectively, means the entire segment will be updated. |
{
"envelopeId": "test-envelope",
"targetRctSpace": {
"herePlatformOrganizationId": "olp-here",
"spaceName": "1"
},
"auditInfo": {
"createdAtUtc": "2026-07-08T13:46:42.732",
"creatorId": "HERE-73b68795-4f0a-40b1-a212-c0d2db04ee2f"
},
"payload": [
{
"type": "action-request",
"id": "1",
"actionCode": "test-insert",
"action": {
"type": "single-action",
"operation": {
"type": "insert",
"id": "1",
"target": "proposed",
"scope": {
"type": "elements",
"elements": [
{
"elementId": "160077647",
"locations": [
{
"type": "percentage",
"from": 0,
"to": 100
}
]
}
]
},
"attribute": {
"properties": [
{
"type": "property-int",
"key": "03",
"value": 200
}
],
"metadata": {}
},
"attributeMergeStrategy": "MERGE_SPATIAL",
"propertiesMergeStrategy": "OVERWRITE_PROPERTIES"
}
},
"changeNotificationExtent": {
"includeOriginalValues": true,
"includeUpdatedValues": true
}
}
]
} For more detailed information on payload schema, see ADZ schema
Submit a payload message
View results
For more information on interpreting the results of the API call, refer to (doc:stream-notifications).