Skip to content

schema: add POI JSON schema v2.0.0#530

Open
raphael-ram wants to merge 3 commits into
Orange-OpenSource:masterfrom
raphael-ram:add-poi-schema
Open

schema: add POI JSON schema v2.0.0#530
raphael-ram wants to merge 3 commits into
Orange-OpenSource:masterfrom
raphael-ram:add-poi-schema

Conversation

@raphael-ram
Copy link
Copy Markdown
Contributor

@raphael-ram raphael-ram commented May 26, 2026

Description

Adds the POIM (Point of Interest Message) JSON Schema v2.0.0 at schema/poim/poim_schema_2-0-0.json.

This schema defines the message format for POIM messages exchanged on the V2X platform (parking availability, road segments, etc.), based on ETSI TS 103 916 v1.1.

Changes

  • Rename directory schema/poi/schema/poim/ to match the actual message name convention
  • Add schema/poim/poim_schema_2-0-0.json: full JSON Schema for POIM messages (v2.0.0)
    • EngineCharacteristics uses real enumerated values from ISO 17573-3 v1.3 (EfcDataDictionary) instead of a generic integer
    • All parking-related enumerations (GoodsType, ParkingFeeType, ParkingReservationType, ArrangementType, CurrentFacilityStatus, OccupancyTrend) populated from ASN.1 sources
    • All dimensional/positional fields annotated with units from ETSI ITS Common Data Dictionary
    • All fields have a description (0 fields without description)

ASN.1 sources used

File Purpose
POIM-PDU-Description.asn Top-level POIM message structure
POIM-CommonContainers.asn Common containers (geo position, wgs84 angle, delta position, etc.)
POIM-ParkingAvailability.asn Parking-specific enumerations and constraints (GoodsType, ParkingFeeType, ParkingReservationType, ArrangementType, CurrentFacilityStatus, OccupancyTrend, EngineCharacteristics)
ETSI-ITS-CDD.asn Units and value ranges for ETSI ITS Common Data Dictionary types (Latitude, Longitude, Altitude, DeltaLatitude, DeltaLongitude, DeltaAltitude, Wgs84AngleValue, Wgs84AngleConfidence, HeightCharacteristic)
EfcDataDictionary-v1-3.asn ISO 17573-3 v1.3 enumerated values for EngineCharacteristics

References

EfcDataDictionary-v1-3.asn

EfcDataDictionary-v1-3.md
ETSI-ITS-CDD.md
POIM-CommonContainers.md
POIM-ParkingAvailability.md
POIM-PDU-Description.md

@mathieu1fb mathieu1fb self-requested a review May 26, 2026 08:25
@mathieu1fb mathieu1fb added the Schema JSON schema files label May 26, 2026
Comment thread schema/denm/denm_schema_2-3-0.json Outdated
Signed-off-by: Raphael Ramanantsoa <raphael.ramanantsoa@orange.com>
Signed-off-by: Raphael Ramanantsoa <raphael.ramanantsoa@orange.com>
Comment thread schema/poi/poim_schema_2-0-0.json Outdated
Comment thread schema/poi/poim_schema_2-0-0.json Outdated
Comment thread schema/poi/poim_schema_2-0-0.json Outdated
Comment thread schema/poim/poim_schema_2-0-0.json
Comment thread schema/poim/poim_schema_2-0-0.json
Comment thread schema/poim/poim_schema_2-0-0.json
Comment thread schema/poim/poim_schema_2-0-0.json
Comment thread schema/poim/poim_schema_2-0-0.json
@mathieu1fb
Copy link
Copy Markdown
Collaborator

I didn't comment on all occurrences, but definition of values is sometimes missing, or the definition is present but the unit is most often missing. The schema should be self-explanatory so it is important to find these missing pieces.

@mathieu1fb
Copy link
Copy Markdown
Collaborator

Also, it would be better to format the directory as poim instead of poi to match with the actual message name, and as we did for the other messages.

- Rename directory poi/ → poim/ to match the actual message name
  and align with other message directories (cam/, denm/, etc.)
- Rename aggregatedstatus → aggregated_status, detailedstatus → detailed_status,
  roadsegment → road_segment (snake_case convention)
- Add enumerated values for goods_type, parking_fee_type,
  parking_reservation_type, arrangement_type, current_facility_status,
  occupancy trend, engine_characteristics (from POIM-ParkingAvailability.asn
  and EfcDataDictionary-v1-3.asn)
- Add units for height_restriction, geo_position lat/lon/alt,
  delta_latitude/longitude/altitude, wgs84_angle value/confidence,
  occupancy rate/confidence (from ETSI-ITS-CDD.asn)
- Add descriptions for all remaining fields: strings (name, address,
  phone_number, website, pricing_information, etc.), arrays, time_of_day
  components, level, begin/end_of_period

Signed-off-by: Raphael Ramanantsoa <raphael.ramanantsoa@orange.com>
@mathieu1fb
Copy link
Copy Markdown
Collaborator

Almost perfect with the new changes, thank you. Can you just remove all the This DE... / This DF... from the descriptions?
For instance, This DE represents... -> Represents...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Schema JSON schema files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants