API Changes: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
(Created page with "In order to improve the API we have made some changes: ==EditorScenario== Complete New event for setting scenario's ==Removed== Following events are no longer needed and thus removed: * EditorLevel (partly renamed to Scenario) * EditorMessage (also endpoint api/session/items/messages) * EditorContributor (also endpoint api/session/items/contributors) * FacilitatorSession ==EditorOverlay== {|class=wikitable ! 2022 ! 2023 |- | ADD_CUSTOM_GRIDOVERLAY_LEGEND_ENTRY | ADD_...")
 
 
(34 intermediate revisions by 2 users not shown)
Line 1: Line 1:
In order to improve the API we have made some changes:
In order to improve the API we have made some changes:
=2024.5.2 Update=
* Renamed Measure event for consistency, TIFF is always GEOTIFF now and a Spatial is Terrain.
* For example Measure event ADD_SPATIAL -> ADD_TERRAIN and REMOVE_SPATIAL -> REMOVE_TERRAIN.
* For example Measure event ADD_TIFF_SPATIAL -> ADD_GEOTIFF and REMOVE_TIFF_SPATIAL -> REMOVE_GEOTIFF.
=2024.4.0 Update=
* First 8 characters of the API token containing the Session ID are now stored in hexadecimals. Session ID can now have the full Integer range from -2 billion to 2 billion IDs. By default the last session ID is re-used when restarting the project.
* Renamed function value GREEN_M2 to VEGETATION_FRACTION which is more appropriate and consistent with existing identical Terrain attribute VEGETATION_FRACTION.
* Water attributes SEEPAGE_FLUCTUATION, SEEPAGE_C and SEEPAGE_P are now called GROUND_BOTTOM_PRESSURE_M, BOTTOM_RESISTANCE and BOTTOM_PRESSURE. Result GROUND_LAST_SEEPAGE -> GROUND_BOTTOM_FLOW.
=2024.3.0 Update=
* Renamed Overlay DISTANCE_ZONE to DISTANCE.
* Renamed Overlay DISTANCE_SIGHT to SIGHT_DISTANCE.
* Renamed avgType (in Average Overlay) to rasterization.
* Removed old deprecated Subsidence overlays: SUBSIDENCE_OXIDATION, SUBSIDENCE_SETTLEMENT, GROUND_WATER_HI, GROUND_WATER_LOW. Use Result-type for this now.
* Renamed Overlay event: SET_AVG_TYPE -> SET_RASTERIZATION
* Removed GeoLink APPEND_ATTRIBUTE, not used.
* Rename Overlay Event ADD_RESULT_CHILD_OVERLAY -> ADD_RESULT_CHILD.
* Add standardized APPEND_ATTRIBUTE and SET_ATTRIBUTES to among others: Areas, Buildings, Overlays, Indicators.
* Removed old web hover endpoint, replaced by generic GetFeatureInfo in WMS with identical results.
=2024.2.0 Update=
* Improved consistency in asset image names. Indicators, Action Menus, Measures, Stakeholders, etc all have an imageName field instead of iconName, portrait etc.
* Overlay FUNCTION_HIGHLIGHT is renamed to FUNCTION and AREAS to AREA.
* Several unused Words have been removed.
* Renamed Overlay events SET_OVERLAY_REST_COLOR to SET_OVERLAY_REMAINDER_COLOR and SET_ICON to SET_IMAGE, SET_IMAGE to SET_OVERLAY_IMAGE.
* Renamed restColor to remainderColor in Area and Function Overlays.
=2024.1.0 Update=
* Zoomlevels (and related events) are not longer accessible via API, functionality was not used.
* All API calls now consistently default to the MAQUETTE version (when not in test run identical to CURRENT), this used to be mixed.
* New endpoints for 3D Tiles, Web Client heightmaps and viewers.
* Added security warning when accessing a Viewer with an API token instead of Stakeholder Web token.
=2024.0.0 Update=
* Location endpoint (api/session/location/) now defaults to the new 2024 API version.
=2023.7.11 Update=
* In order to support password expiry a new field was added to the User endpoint: "passwdExpiryDate".
* To improve privacy the "macs" field is removed from the User endpoint.
=2023.7.5 Update=
* Added isActive boolean to Indicator endpoint, replaces deprecated active map.
* Editor/START_MAP_CREATION has "optional" additional value to set the area of interest.
* Editor/START_MAP_CREATION has option to change the CRS to something else then default EPSG 3857.
* Location endpoint has new version with additional information, defaults to old info.
=2023.6.0 Update=
==User==
{|class=wikitable
! 2022
! 2023
|-
| GET_MY_HASH_KEY
| GET_MY_LOGIN_KEY (rename only)
|}


==EditorScenario==
==EditorScenario==
Line 53: Line 111:




==EditorArea & EditorBuilding & EditorZoning==
==EditorArea & EditorBuilding & EditorZoning==


{|class=wikitable
{|class=wikitable

Latest revision as of 20:23, 8 November 2023

In order to improve the API we have made some changes:

2024.5.2 Update

  • Renamed Measure event for consistency, TIFF is always GEOTIFF now and a Spatial is Terrain.
  • For example Measure event ADD_SPATIAL -> ADD_TERRAIN and REMOVE_SPATIAL -> REMOVE_TERRAIN.
  • For example Measure event ADD_TIFF_SPATIAL -> ADD_GEOTIFF and REMOVE_TIFF_SPATIAL -> REMOVE_GEOTIFF.

2024.4.0 Update

  • First 8 characters of the API token containing the Session ID are now stored in hexadecimals. Session ID can now have the full Integer range from -2 billion to 2 billion IDs. By default the last session ID is re-used when restarting the project.
  • Renamed function value GREEN_M2 to VEGETATION_FRACTION which is more appropriate and consistent with existing identical Terrain attribute VEGETATION_FRACTION.
  • Water attributes SEEPAGE_FLUCTUATION, SEEPAGE_C and SEEPAGE_P are now called GROUND_BOTTOM_PRESSURE_M, BOTTOM_RESISTANCE and BOTTOM_PRESSURE. Result GROUND_LAST_SEEPAGE -> GROUND_BOTTOM_FLOW.

2024.3.0 Update

  • Renamed Overlay DISTANCE_ZONE to DISTANCE.
  • Renamed Overlay DISTANCE_SIGHT to SIGHT_DISTANCE.
  • Renamed avgType (in Average Overlay) to rasterization.
  • Removed old deprecated Subsidence overlays: SUBSIDENCE_OXIDATION, SUBSIDENCE_SETTLEMENT, GROUND_WATER_HI, GROUND_WATER_LOW. Use Result-type for this now.
  • Renamed Overlay event: SET_AVG_TYPE -> SET_RASTERIZATION
  • Removed GeoLink APPEND_ATTRIBUTE, not used.
  • Rename Overlay Event ADD_RESULT_CHILD_OVERLAY -> ADD_RESULT_CHILD.
  • Add standardized APPEND_ATTRIBUTE and SET_ATTRIBUTES to among others: Areas, Buildings, Overlays, Indicators.
  • Removed old web hover endpoint, replaced by generic GetFeatureInfo in WMS with identical results.

2024.2.0 Update

  • Improved consistency in asset image names. Indicators, Action Menus, Measures, Stakeholders, etc all have an imageName field instead of iconName, portrait etc.
  • Overlay FUNCTION_HIGHLIGHT is renamed to FUNCTION and AREAS to AREA.
  • Several unused Words have been removed.
  • Renamed Overlay events SET_OVERLAY_REST_COLOR to SET_OVERLAY_REMAINDER_COLOR and SET_ICON to SET_IMAGE, SET_IMAGE to SET_OVERLAY_IMAGE.
  • Renamed restColor to remainderColor in Area and Function Overlays.

2024.1.0 Update

  • Zoomlevels (and related events) are not longer accessible via API, functionality was not used.
  • All API calls now consistently default to the MAQUETTE version (when not in test run identical to CURRENT), this used to be mixed.
  • New endpoints for 3D Tiles, Web Client heightmaps and viewers.
  • Added security warning when accessing a Viewer with an API token instead of Stakeholder Web token.

2024.0.0 Update

  • Location endpoint (api/session/location/) now defaults to the new 2024 API version.

2023.7.11 Update

  • In order to support password expiry a new field was added to the User endpoint: "passwdExpiryDate".
  • To improve privacy the "macs" field is removed from the User endpoint.

2023.7.5 Update

  • Added isActive boolean to Indicator endpoint, replaces deprecated active map.
  • Editor/START_MAP_CREATION has "optional" additional value to set the area of interest.
  • Editor/START_MAP_CREATION has option to change the CRS to something else then default EPSG 3857.
  • Location endpoint has new version with additional information, defaults to old info.

2023.6.0 Update

User

2022 2023
GET_MY_HASH_KEY GET_MY_LOGIN_KEY (rename only)

EditorScenario

Complete New event for setting scenario's

Removed

Following events are no longer needed and thus removed:

  • EditorLevel (partly renamed to Scenario)
  • EditorMessage (also endpoint api/session/items/messages)
  • EditorContributor (also endpoint api/session/items/contributors)
  • FacilitatorSession

EditorOverlay

2022 2023
ADD_CUSTOM_GRIDOVERLAY_LEGEND_ENTRY ADD_LEGEND_ENTRY (rename only)
REMOVE_CUSTOM_OVERLAY_LEGEND_ENTRY REMOVE_LEGEND_ENTRY (rename only)
SET_CUSTOM_OVERLAY_LEGEND SET_CUSTOM_LEGEND (rename only)
SET_CUSTOM_OVERLAY_LEGEND_ENTRY_COLOR SET_LEGEND_ENTRY_COLOR (rename only)
SET_CUSTOM_OVERLAY_LEGEND_ENTRY_NAME SET_LEGEND_ENTRY_NAME (rename only)
SET_CUSTOM_OVERLAY_LEGEND_ENTRY_VALUE SET_LEGEND_ENTRY_VALUE (rename only)
SET_ICON (new functionality)
SET_VISIBLE (new functionality)

EditorActionMenu

2022 2023
SET_ACTIVE_FOR_STAKEHOLDER_AND_LEVEL SET_ACTIVE_FOR_STAKEHOLDER_AND_SCENARIO (rename only)


EditorArea & EditorBuilding & EditorZoning

2022 2023
IMPORT Added optional parameter to set the buffer

EditorGeoLink

2022 2023
New functionality REMOVE_FUNCTION, SET_POINT_BUFFER, SET_LINE_BUFFER, SET_GEOMETRY_MODE

EditorGlobal

2022 2023
SET_READ_ONLY_START_VALUE Removed, no longer needed


EditorIndicator

2022 2023
DUPLICATE_PERSONAL_INDICATOR Deprecated, use DUPLICATE_INDICATOR

EditorLevee

2022 2023
New functionality REMOVE_SIDE_FUNCTION, REMOVE_TOP_FUNCTION


EditorMeasure

2022 2023
New functionality ADD_TIFF_SPATIAL, ADD_TIFF_POLYGONS, IMPORT_BUILDING_EXISTING_MEASURE, REMOVE_TIFF_SPATIAL, SET_AUTOMATIC_TIFF_POLYGONS, SET_GEOTIFF, SET_SPATIAL_TERRAIN_TYPE
SET_FIXED_WATER_STORAGE Removed, no longer needed

EditorNeighborhood

2022 2023
SET_ACTIVE Removed parameter to level.

EditorNetNode

2022 2023
SET_LOCATION Added parameter to set the merge distance.

EditorSetting

2022 2023
New functionality GET_SUN_AZIMUTH, GET_SUN_ALTITUDE, GET_SUN_MOTION, GET_EPOCH_TIME, SET_IMPORT_CRS
SET_FACILITATOR_TAB_ACTIVE, SET_COMMERCIAL_NAME, SET_VIEWFLOW_ACTIVE, SET_INTRO_IMAGE Removed functionality
Check Setting for all types.

EditorStakeholder

2022 2023
SELECT_PREF_OR_FIRST_PLAYABLE_STAKEHOLDER SELECT_STAKEHOLDER (rename only)
SET_PLAYABLE SET_ACTIVE (rename only)
ADD_WITH_TYPE_AND_PLAYABLE ADD_WITH_TYPE_AND_ACTIVE (rename only)
SET_DESCRIPTION, SET_INDICATOR_WEIGHT, SET_LEVEL_ASSIGNMENT, SET_LEVEL_BUDGET_INCREMENT, ADD_INDICATOR_WEIGHT Removed functionality


EditorTime

2022 2023
SET_NUMBER_OF_PAUSE_MOMENTS, SET_SESSION_DURATION_HOURS, SET_SIM_TIME_TYPE, SET_SIMULATION_DURATION_YEARS Removed functionality


EditorUpgrade

2022 2023
SET_CONSTRUCTION_TIME_MONTHS Removed functionality

EditorNetCluster

2022 2023
SET_LEVEL SET_SCENARIO (rename only)

Answer

2022 2023
DELETE_MESSAGE, MEASURE_ASK_DEMOLISH_DATE, MEASURE_DEMOLISH_APPROVAL, WATER_ASK_APPROVAL, WATER_CONFIRM Removed, no longer used

Client

2022 2023
MESSAGE_ANSWERED, MESSAGE_MOTIVATION_ANSWER Removed, no longer used

Logic

2022 2023
BEAMER_SET_OVERLAY_ID, BEAMER_SET_OVERLAY_DIFFERENCE, BEAMER_SET_SCORE_PANEL, BEAMER_SET_VIEW, BEAMER_SWITCH, MEASURE_UPDATE_CUSTOM, MESSAGE_ACTIVATE, MESSAGE_RESET, MESSAGE_REVOKE, SETTINGS_ALLOW_INTERACTION, SETTINGS_SET_ALLOWED_WATER_LEVEL_INCREASE, SETTINGS_SET_MESSAGE_AUTO_RESPOND, SETTINGS_TEAM_NAME,TIME_SET_SIM_MULTIPLIER Removed, no longer used
LEVEL_SET_ACTIVE SCENARIO_SET_ACTIVE (rename only)


Participant

2022 2023
LOAN_ACTIVATE, LOAN_NEW, MEASURE_CREATE_CUSTOM, MEASURE_PLAN_DEMOLISH, MEASURE_SET_WATER_CLASSIFICATION, MESSAGE_ANSWER, MESSAGE_ANSWER_WITH_MOTIVATION, MESSAGE_NEW, MONEY_TRANSFER_ASK Removed, no longer used