This endpoint allows users to download SAE J2735 or ETSI MAP messages as a JSON list. Depending on the expectedType parameter, the response contains either ASN.1 UPER base64-encoded messages with their respective region and intersection IDs, or fully decoded JSON messages. The area for MAP message retrieval must be defined in the request body using one of two methods: An array of region and intersection ID pairs, or a GeoJSON geofence specification.
thingspace_oauth sessionToken Access/Bearer token needed to authorize the user. The Bearer/Access Token should be acquired by using the ThingSpace Portal (thingspace.verizon.com). For details on how to obtain the token please refer to the
In: header
This is the Session/M2M token needed to authenticate the user. It should be acquired by using the ThingSpace APIs. For detail on how to obtain a Session/M2M token please refer to the
In: header
The VendorID set during the Vendor registration call.
^[a-zA-Z0-9]+$length <= 64application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request structure for querying MAP records. Provide either regionIntersectionPairs (coordinates) or geoJson, not both.
Query MAP records using specific region and intersection identifier pairs
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v2/mapdata/query" \ -H "VendorID: VzMapManager" \ -H "Content-Type: application/json" \ -d '{ "messageStandard": "sae", "expectedType": "BASE64", "pageSize": 50, "regionIntersectionPairs": [ { "regionId": 100, "intersectionId": 5233 } ] }'[ { "messageStandard": "sae", "regionId": 100, "intersectionId": 5233, "payload": "asdfKDSiORel23==" }]{ "error": "Error-Summary", "description": "Error-Description", "uuid": "a4fcd16a-343d-4527-8203-2f46e3e4ff4b", "timestamp": "2023-02-15T14:30:00.123456789Z"}{ "error": "Error-Summary", "description": "Error-Description", "uuid": "a4fcd16a-343d-4527-8203-2f46e3e4ff4b", "timestamp": "2023-02-15T14:30:00.123456789Z"}{ "error": "Error-Summary", "description": "Error-Description", "uuid": "a4fcd16a-343d-4527-8203-2f46e3e4ff4b", "timestamp": "2023-02-15T14:30:00.123456789Z"}{ "error": "Error-Summary", "description": "Error-Description", "uuid": "a4fcd16a-343d-4527-8203-2f46e3e4ff4b", "timestamp": "2023-02-15T14:30:00.123456789Z"}{ "error": "Error-Summary", "description": "Error-Description", "uuid": "a4fcd16a-343d-4527-8203-2f46e3e4ff4b", "timestamp": "2023-02-15T14:30:00.123456789Z"}{ "error": "Error-Summary", "description": "Error-Description", "uuid": "a4fcd16a-343d-4527-8203-2f46e3e4ff4b", "timestamp": "2023-02-15T14:30:00.123456789Z"}{ "error": "Error-Summary", "description": "Error-Description", "uuid": "a4fcd16a-343d-4527-8203-2f46e3e4ff4b", "timestamp": "2023-02-15T14:30:00.123456789Z"}V2X messaging standard selection. Accepted values are 'sae' (SAE J2735) and 'etsi' (ETSI TS 103 301).
^(etsi|sae)$length <= 4"sae"Value in
List of region and intersection ID pairs to retrieve MAP messages for.
items <= 200The format of the payload in the response body.
^(BASE64|JSON)$length <= 6"BASE64"Value in
Base64 encoded token used to retrieve the next page of results
^[A-Za-z0-9+/]+=*$length <= 500Maximum number of records to return in a single page
int321 <= value <= 500200