Problem description

Multiple APIs are using a similar data type (a profiled variant) for describing an Area, which allows a description of a service area or geographical area in form of a circle and/or a polygon.

• The location-retrieval API (Device Location), region-device-count API and the proposed NetworkSliceBooking API allow an Area definition in form of a circle or a polygon.
• The geofencing-subscriptions API (Device Location) and the location-verification (Device Location) API only allow circles.
• The population-density-data API only allows a polygon.

Note, a similar ‘Area’ definition is also available in 3GPP (TS 29.572). There are some differences, like the data type is named GeographicArea or the PointList is a list of GeographicalCoordinates (no Points).

Expected action

• A new data type for describing service areas is added to CAMARA_common.yaml.
• Potential restrictions (e.g. allowing intersecting polygon lines, etc) should be discussed and documented.