UNI-Cloud API 1.1

Homepage Integration

Overviewchevron_right
Endpointschevron_right

API Changelog

Please beware that the documentation is still in Alpha!

GeoJson (Beta)

GeoJSON is a format for encoding a variety of geographic data structures. This format is described in RFC 7946 as found on GeoJson.org

Endpoints
1linkGET /v1/survey/exports/geojson/{projectid}

2linkPOST /v1/survey/exports/geojson/{projectid}

3linkPOST /v1/survey/exports/geojson/{projectid}/{layerid}

linkGET Get Geo Json Project

ReadOnly

HTTP-Get handler to receive export UNI-Cloud project as a GeoJSON object.

Parameters
chevron_right
  • projectIdGuid

    The identifier of a project.

Returns
chevron_right

    A GeoJson object that represents an UNI-Cloud project export.

get
1linkGET https://api.marxact.com/v1/Survey/exports/geojson/{projectid} HTTP/1.1

2linkAuthorization: Bearer {{token}}

response
1linkHTTP/1.1 200 OK

2linkContent-Type: application/json

3link{

4link "type": "FeatureCollection",

5link "features": [

6link {

7link "type": "Feature",

8link "id": "00000000-0000-0000-0000-000000000000",

9link "geometry": {

10link "type": "Point",

11link "coordinates": [

12link 4.833921,

13link 52.3547498,

14link 12

15link ]

16link },

17link "properties": {

18link "layer_id": "00000000-0000-0000-0000-000000000000",

19link "layer_name": "0",

20link "layer_description": "Default layer",

21link "layer_color": "#000000",

22link "attributes": "",

23link "undulation": 0,

24link "created_date": "2022-08-22T00:00:00Z",

25link "latitude": 52.2109918,

26link "longitude": 5.1944709,

27link "height": 15.2,

28link "solution_status": "FIX",

29link "positioning_mode": "RTK",

30link "solution_age": 0,

31link "differential_age": 2,

32link "satellites_in_use": 36,

33link "satellites_tracked": 40,

34link "base_id": "4095",

35link "latitude_deviation": 0.0203,

36link "longitude_deviation": 0.0122,

37link "height_deviation": 0.0271

38link }

39link },

40link {

41link "type": "Feature",

42link "id": "00000000-0000-0000-0000-000000000000",

43link "geometry": {

44link "type": "Point",

45link "coordinates": [

46link 4.833921,

47link 52.3547498,

48link 10

49link ]

50link },

51link "properties": {

52link "layer_id": "00000000-0000-0000-0000-000000000000",

53link "layer_name": "0",

54link "layer_description": "Default layer",

55link "layer_color": "#000000",

56link "attributes": "",

57link "undulation": 0,

58link "created_date": "2022-08-22T00:00:00Z",

59link "latitude": 52.2109918,

60link "longitude": 5.1944709,

61link "height": 15.2,

62link "solution_status": "FIX",

63link "positioning_mode": "RTK",

64link "solution_age": 0,

65link "differential_age": 2,

66link "satellites_in_use": 36,

67link "satellites_tracked": 40,

68link "base_id": "4095",

69link "latitude_deviation": 0.0203,

70link "longitude_deviation": 0.0122,

71link "height_deviation": 0.0271

72link }

73link }

74link ]

75link}

linkPOST Post Geo Json

User

HTTP-Post handler that import GeoJson objects into an existing UNI-Cloud project into the default layer.

For the moment this feature supports only the import of Points (not Polyline or Polygons), this means the only possible GeoJSON geometry type that can be used now is Point.
Coordinates order, as per the GeoJSON specification go as [x, y, z] or [longitude, latitude, altitude]. You can omit the third parameter (z or altitude).

Route Parameters
chevron_right
  • projectIdGuid

    The identifier of the Project.
Body Parameters
chevron_right

    The body must contain a valid GeoJson model, containing optional custom marXact properties.

    Supported marXact Properties
    chevron_right
    • coordinateReferenceSystemCoordinateReferenceSystem

      The coordinate reference system for the supplied coordinates. This property must have the same value for all shapes.
      For a list of supported Coordinate Reference systems and their identifiers (i.e. for The Netherlands use ‘RDNAP2018’) please see the Supported CRS List.

    • nameString

      otherwise one will be auto-generated.

Returns
chevron_right

    The imported result.

post
1linkPOST https://api.marxact.com/v1/Survey/imports/geojson/{projectid} HTTP/1.1

2linkAuthorization: Bearer {{token}}

3linkContent-Type: application/json

4link

5link{

6link "type": "FeatureCollection",

7link "Features": [

8link {

9link "type": "Feature",

10link "geometry": [

11link {

12link "type": "Point",

13link "coordinates": [

14link 5.884975404,

15link 51.004394281

16link ]

17link }

18link ],

19link "properties": [

20link {

21link "coordinateReferenceSystem": "RDNAP2018",

22link "name": "Optional name here"

23link }

24link ]

25link },

26link {

27link "type": "Feature",

28link "geometry": [

29link {

30link "type": "Point",

31link "coordinates": [

32link 51.004394281,

33link 5.884975404

34link ]

35link }

36link ],

37link "properties": [

38link {

39link "coordinateReferenceSystem": "RDNAP2018",

40link "name": "Optional name here"

41link }

42link ]

43link }

44link ]

45link}

response
1linkHTTP/1.1 200 OK

2linkContent-Type: application/json

3link{

4link "type": "FeatureCollection",

5link "Features": [

6link {

7link "type": "Feature",

8link "geometry": [

9link {

10link "type": "Point",

11link "coordinates": [

12link 5.884975404,

13link 51.004394281

14link ]

15link }

16link ],

17link "properties": [

18link {

19link "coordinateReferenceSystem": "RDNAP2018",

20link "name": "Optional name here",

21link "id": "7b41356c-4922-4635-a9a9-cd7fb90e29c8"

22link }

23link ]

24link },

25link {

26link "type": "Feature",

27link "geometry": [

28link {

29link "type": "Point",

30link "coordinates": [

31link 51.004394281,

32link 5.884975404

33link ]

34link }

35link ],

36link "properties": [

37link {

38link "coordinateReferenceSystem": "RDNAP2018",

39link "name": "Optional name here",

40link "id": "950b049a-446c-4dd1-b04c-7435433e9dbe"

41link }

42link ]

43link }

44link ]

45link}

linkPOST Post Geo Json Project

User

HTTP-Post handler that import GeoJson objects into an existing UNI-Cloud project into the provided layer

For the moment this feature supports only the import of Points (not Polyline or Polygons), this means the only possible GeoJSON geometry type that can be used now is Point.
Coordinates order, as per the GeoJSON specification go as [x, y, z] or [longitude, latitude, altitude]. You can omit the third parameter (z or altitude).

Route Parameters
chevron_right
  • projectIdGuid

    The identifier of the project.
  • layerIdGuid

    The identifier of the layer.
Body Parameters
chevron_right

    The body must contain a valid GeoJson model, containing optional custom marXact properties.

    Supported marXact Properties
    chevron_right
    • coordinateReferenceSystemCoordinateReferenceSystem

      The coordinate reference system for the supplied coordinates. This property must have the same value for all shapes.
      For a list of supported Coordinate Reference systems and their identifiers (i.e. for The Netherlands use ‘RDNAP2018’) please see the Supported CRS List.

    • nameString

      otherwise one will be auto-generated.

Returns
chevron_right

    The imported result.

post
1linkPOST https://api.marxact.com/v1/Survey/imports/geojson/{projectid}/{layerid} HTTP/1.1

2linkAuthorization: Bearer {{token}}

3linkContent-Type: application/json

4link

5link{

6link "type": "FeatureCollection",

7link "Features": [

8link {

9link "type": "Feature",

10link "geometry": [

11link {

12link "type": "Point",

13link "coordinates": [

14link 5.884975404,

15link 51.004394281

16link ]

17link }

18link ],

19link "properties": [

20link {

21link "coordinateReferenceSystem": "RDNAP2018",

22link "name": "Optional name here"

23link }

24link ]

25link },

26link {

27link "type": "Feature",

28link "geometry": [

29link {

30link "type": "Point",

31link "coordinates": [

32link 51.004394281,

33link 5.884975404

34link ]

35link }

36link ],

37link "properties": [

38link {

39link "coordinateReferenceSystem": "RDNAP2018",

40link "name": "Optional name here"

41link }

42link ]

43link }

44link ]

45link}

response
1linkHTTP/1.1 200 OK

2linkContent-Type: application/json

3link{

4link "type": "FeatureCollection",

5link "Features": [

6link {

7link "type": "Feature",

8link "geometry": [

9link {

10link "type": "Point",

11link "coordinates": [

12link 5.884975404,

13link 51.004394281

14link ]

15link }

16link ],

17link "properties": [

18link {

19link "coordinateReferenceSystem": "RDNAP2018",

20link "name": "Optional name here",

21link "id": "7b41356c-4922-4635-a9a9-cd7fb90e29c8"

22link }

23link ]

24link },

25link {

26link "type": "Feature",

27link "geometry": [

28link {

29link "type": "Point",

30link "coordinates": [

31link 51.004394281,

32link 5.884975404

33link ]

34link }

35link ],

36link "properties": [

37link {

38link "coordinateReferenceSystem": "RDNAP2018",

39link "name": "Optional name here",

40link "id": "950b049a-446c-4dd1-b04c-7435433e9dbe"

41link }

42link ]

43link }

44link ]

45link}