User Tools

Site Tools


standards:adf_extensions_2018

2018 Extensions to ADF

ADF has served the AGTEK mobile applications well since 2010 but there have been additional requirements. It is desirable to add new capabilities to ADF and should be done in a way that's backwards compatible with existing applications. Generally backwards compatibility is accomplished by providing new entry types in the ADF zip, and older applications ignore the new entry types. Thus this requirement note doesn't aspire to change existing ADF types.

New ADF data entities

Modern use cases are as follows:

  1. A user places notes, pictures, perhaps other types of single point marks on a project. When reopening the file the marks should be retained. These should be part of the ADF so it can be uploaded to the server and other users are able to see these notations. Placemark style objects - Photos, Notes, others.
  2. A user creates a track, or measures an area. When reopening the file these should be retained. These should be part of the ADF so it can be uploaded and other users are able to see these notations. Path like object - User tracks, measure areas, etc.
  3. It id intended that the server extract “journal” entries from previously stored KMZ files. The most relevant of these would be user tracks and measure areas. These could be stored in an LLA capable ADF structure, and linked to from the journal.
  4. Layer settings should be part of the ADF so the visibility state can be retained. This functionality is part of SmartPlan, but should be part of ADF and standardized across all applications. Visibility, selectibility, color, layer information (HTML fragment) information for layers.

Object 1 & 2 must be LLA based. This means that ADF files without benchmark information can not display this information since the bulk of ADF is NEZ. (e.g. SmartGrade with no benchmarks can't display).

Entity attributes

  • Placemark attributes
    1. name : string : required
    2. Latitude : decimal degrees
    3. Longitude : decimal degrees
    4. Altitude : decimal meters
  • Path attributes
    1. name : string : required
    2. points[] = { latitude, longitude, altitude (same to placemark) }
  • Layer attributes - Per layer
    1. name : string : required
    2. visible : boolean : default true
    3. selectable : boolean : default true
    4. color : int32 : default platform dependent (mobile == black, desktop == white?)

New ADF Entries to be defined

  • Placemark - supporting the previously listed attributes
  • Path - supporting the previously listed attributes
  • Visibility - Support visibility attributes, each per layer.
standards/adf_extensions_2018.txt · Last modified: 2018/03/22 22:45 by mjallison