@situm/cordova 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (313) hide show
  1. package/CHANGELOG.md +3 -0
  2. package/CHANGELOG_UNRELEASED.md +28 -0
  3. package/Jenkinsfile +84 -0
  4. package/LICENSE +21 -0
  5. package/README.md +472 -0
  6. package/azure/common-steps.yaml +5 -0
  7. package/azure-pipelines.yml +336 -0
  8. package/docs/JSDoc/MapView.html +300 -0
  9. package/docs/JSDoc/MapViewControllerImpl.html +299 -0
  10. package/docs/JSDoc/Situm.html +5257 -0
  11. package/docs/JSDoc/android_Interfaces.js.html +825 -0
  12. package/docs/JSDoc/android_situm.js.html +380 -0
  13. package/docs/JSDoc/fonts/glyphicons-halflings-regular.eot +0 -0
  14. package/docs/JSDoc/fonts/glyphicons-halflings-regular.svg +288 -0
  15. package/docs/JSDoc/fonts/glyphicons-halflings-regular.ttf +0 -0
  16. package/docs/JSDoc/fonts/glyphicons-halflings-regular.woff +0 -0
  17. package/docs/JSDoc/fonts/glyphicons-halflings-regular.woff2 +0 -0
  18. package/docs/JSDoc/global.html +7538 -0
  19. package/docs/JSDoc/img/toast-ui.png +0 -0
  20. package/docs/JSDoc/index.html +90 -0
  21. package/docs/JSDoc/map-view-controller.js.html +307 -0
  22. package/docs/JSDoc/map-view.js.html +172 -0
  23. package/docs/JSDoc/scripts/jquery.min.js +2 -0
  24. package/docs/JSDoc/scripts/linenumber.js +30 -0
  25. package/docs/JSDoc/scripts/prettify/Apache-License-2.0.txt +202 -0
  26. package/docs/JSDoc/scripts/prettify/lang-css.js +2 -0
  27. package/docs/JSDoc/scripts/prettify/prettify.js +28 -0
  28. package/docs/JSDoc/scripts/tui-doc.js +200 -0
  29. package/docs/JSDoc/styles/bootstrap.min.css +6 -0
  30. package/docs/JSDoc/styles/custom.css +23 -0
  31. package/docs/JSDoc/styles/prettify-jsdoc.css +111 -0
  32. package/docs/JSDoc/styles/prettify-tomorrow.css +132 -0
  33. package/docs/JSDoc/styles/tui-doc.css +485 -0
  34. package/docs/conf.json +28 -0
  35. package/docs/getting-started.md +298 -0
  36. package/docs/imagotype-SITUM-transparent-90.png +0 -0
  37. package/docs/static/styles/custom.css +23 -0
  38. package/package.json +60 -0
  39. package/plugin.xml +102 -0
  40. package/scripts/update_changelog.sh +22 -0
  41. package/src/android/app/build.gradle +51 -0
  42. package/src/android/app/proguard-rules.pro +21 -0
  43. package/src/android/app/src/main/AndroidManifest.xml +11 -0
  44. package/src/android/app/src/main/java/es/situm/plugin/DateUtils.java +15 -0
  45. package/src/android/app/src/main/java/es/situm/plugin/PluginHelper.java +919 -0
  46. package/src/android/app/src/main/java/es/situm/plugin/SitumMapper.java +968 -0
  47. package/src/android/app/src/main/java/es/situm/plugin/SitumPlugin.java +109 -0
  48. package/src/android/app/src/main/res/drawable/ic_launcher_background.xml +170 -0
  49. package/src/android/app/src/main/res/drawable-v24/ic_launcher_foreground.xml +34 -0
  50. package/src/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml +5 -0
  51. package/src/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml +5 -0
  52. package/src/android/app/src/main/res/mipmap-hdpi/ic_launcher.png +0 -0
  53. package/src/android/app/src/main/res/mipmap-hdpi/ic_launcher_round.png +0 -0
  54. package/src/android/app/src/main/res/mipmap-mdpi/ic_launcher.png +0 -0
  55. package/src/android/app/src/main/res/mipmap-mdpi/ic_launcher_round.png +0 -0
  56. package/src/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png +0 -0
  57. package/src/android/app/src/main/res/mipmap-xhdpi/ic_launcher_round.png +0 -0
  58. package/src/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png +0 -0
  59. package/src/android/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.png +0 -0
  60. package/src/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png +0 -0
  61. package/src/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png +0 -0
  62. package/src/android/app/src/main/res/values/colors.xml +6 -0
  63. package/src/android/app/src/main/res/values/strings.xml +3 -0
  64. package/src/android/app/src/main/res/values/styles.xml +11 -0
  65. package/src/android/app/src/test/java/es/situm/plugin/PluginHelperTest.java +27 -0
  66. package/src/android/app/src/test/java/es/situm/plugin/SitumMapperTest.java +1485 -0
  67. package/src/android/app/src/test/java/es/situm/plugin/angle/AngleCreator.java +46 -0
  68. package/src/android/app/src/test/java/es/situm/plugin/bounds/BoundsCreator.java +50 -0
  69. package/src/android/app/src/test/java/es/situm/plugin/building/BuildingCreator.java +76 -0
  70. package/src/android/app/src/test/java/es/situm/plugin/cartesianCoordinate/CartesianCoordinateCreator.java +31 -0
  71. package/src/android/app/src/test/java/es/situm/plugin/circle/CircleCreator.java +41 -0
  72. package/src/android/app/src/test/java/es/situm/plugin/coordinate/CoordinateCreator.java +32 -0
  73. package/src/android/app/src/test/java/es/situm/plugin/dimensions/DimensionsCreator.java +31 -0
  74. package/src/android/app/src/test/java/es/situm/plugin/directionsRequest/DirectionsRequestCreator.java +105 -0
  75. package/src/android/app/src/test/java/es/situm/plugin/event/EventCreator.java +108 -0
  76. package/src/android/app/src/test/java/es/situm/plugin/floor/FloorCreator.java +58 -0
  77. package/src/android/app/src/test/java/es/situm/plugin/indication/IndicationCreator.java +40 -0
  78. package/src/android/app/src/test/java/es/situm/plugin/location/LocationCreator.java +197 -0
  79. package/src/android/app/src/test/java/es/situm/plugin/locationRequest/LocationRequestCreator.java +45 -0
  80. package/src/android/app/src/test/java/es/situm/plugin/locationStatus/LocationStatusCreator.java +211 -0
  81. package/src/android/app/src/test/java/es/situm/plugin/navigationProgress/NavigationProgressCreator.java +154 -0
  82. package/src/android/app/src/test/java/es/situm/plugin/poi/PoiCreator.java +126 -0
  83. package/src/android/app/src/test/java/es/situm/plugin/poiCategory/PoiCategoryCreator.java +38 -0
  84. package/src/android/app/src/test/java/es/situm/plugin/point/PointCreator.java +200 -0
  85. package/src/android/app/src/test/java/es/situm/plugin/route/RouteCreator.java +142 -0
  86. package/src/android/app/src/test/java/es/situm/plugin/routeStep/RouteStepCreator.java +173 -0
  87. package/src/android/app/src/test/java/es/situm/plugin/situmConversionArea/SitumConversionAreaCreator.java +35 -0
  88. package/src/android/build.gradle +31 -0
  89. package/src/android/gradle/wrapper/gradle-wrapper.jar +0 -0
  90. package/src/android/gradle/wrapper/gradle-wrapper.properties +6 -0
  91. package/src/android/gradle.properties +16 -0
  92. package/src/android/gradlew +172 -0
  93. package/src/android/gradlew.bat +84 -0
  94. package/src/android/settings.gradle +3 -0
  95. package/src/android/situm.gradle +19 -0
  96. package/src/ios/Classes/Private/CDVDebug.h +25 -0
  97. package/src/ios/Classes/Private/CDVJSON_private.h +31 -0
  98. package/src/ios/Classes/Private/CDVJSON_private.m +99 -0
  99. package/src/ios/Classes/Private/CDVPlugin+Private.h +24 -0
  100. package/src/ios/Classes/Private/CDVPlugins/CDVGestureHandler/CDVGestureHandler.h +26 -0
  101. package/src/ios/Classes/Private/CDVPlugins/CDVGestureHandler/CDVGestureHandler.m +70 -0
  102. package/src/ios/Classes/Private/CDVPlugins/CDVHandleOpenURL/CDVHandleOpenURL.h +27 -0
  103. package/src/ios/Classes/Private/CDVPlugins/CDVHandleOpenURL/CDVHandleOpenURL.m +86 -0
  104. package/src/ios/Classes/Private/CDVPlugins/CDVIntentAndNavigationFilter/CDVIntentAndNavigationFilter.h +34 -0
  105. package/src/ios/Classes/Private/CDVPlugins/CDVIntentAndNavigationFilter/CDVIntentAndNavigationFilter.m +153 -0
  106. package/src/ios/Classes/Private/CDVPlugins/CDVLocalStorage/CDVLocalStorage.h +50 -0
  107. package/src/ios/Classes/Private/CDVPlugins/CDVLocalStorage/CDVLocalStorage.m +487 -0
  108. package/src/ios/Classes/Private/CDVPlugins/CDVLogger/CDVLogger.h +26 -0
  109. package/src/ios/Classes/Private/CDVPlugins/CDVLogger/CDVLogger.m +37 -0
  110. package/src/ios/Classes/Private/CDVPlugins/CDVUIWebViewEngine/CDVUIWebViewDelegate.h +41 -0
  111. package/src/ios/Classes/Private/CDVPlugins/CDVUIWebViewEngine/CDVUIWebViewDelegate.m +399 -0
  112. package/src/ios/Classes/Private/CDVPlugins/CDVUIWebViewEngine/CDVUIWebViewEngine.h +27 -0
  113. package/src/ios/Classes/Private/CDVPlugins/CDVUIWebViewEngine/CDVUIWebViewEngine.m +202 -0
  114. package/src/ios/Classes/Private/CDVPlugins/CDVUIWebViewEngine/CDVUIWebViewNavigationDelegate.h +29 -0
  115. package/src/ios/Classes/Private/CDVPlugins/CDVUIWebViewEngine/CDVUIWebViewNavigationDelegate.m +153 -0
  116. package/src/ios/Classes/Public/CDV.h +32 -0
  117. package/src/ios/Classes/Public/CDVAppDelegate.h +28 -0
  118. package/src/ios/Classes/Public/CDVAppDelegate.m +118 -0
  119. package/src/ios/Classes/Public/CDVAvailability.h +111 -0
  120. package/src/ios/Classes/Public/CDVAvailabilityDeprecated.h +26 -0
  121. package/src/ios/Classes/Public/CDVCommandDelegate.h +51 -0
  122. package/src/ios/Classes/Public/CDVCommandDelegateImpl.h +36 -0
  123. package/src/ios/Classes/Public/CDVCommandDelegateImpl.m +186 -0
  124. package/src/ios/Classes/Public/CDVCommandQueue.h +39 -0
  125. package/src/ios/Classes/Public/CDVCommandQueue.m +194 -0
  126. package/src/ios/Classes/Public/CDVConfigParser.h +30 -0
  127. package/src/ios/Classes/Public/CDVConfigParser.m +81 -0
  128. package/src/ios/Classes/Public/CDVInvokedUrlCommand.h +52 -0
  129. package/src/ios/Classes/Public/CDVInvokedUrlCommand.m +116 -0
  130. package/src/ios/Classes/Public/CDVPlugin+Resources.h +39 -0
  131. package/src/ios/Classes/Public/CDVPlugin+Resources.m +38 -0
  132. package/src/ios/Classes/Public/CDVPlugin.h +85 -0
  133. package/src/ios/Classes/Public/CDVPlugin.m +202 -0
  134. package/src/ios/Classes/Public/CDVPluginResult.h +66 -0
  135. package/src/ios/Classes/Public/CDVPluginResult.m +186 -0
  136. package/src/ios/Classes/Public/CDVScreenOrientationDelegate.h +33 -0
  137. package/src/ios/Classes/Public/CDVTimer.h +27 -0
  138. package/src/ios/Classes/Public/CDVTimer.m +123 -0
  139. package/src/ios/Classes/Public/CDVURLProtocol.h +27 -0
  140. package/src/ios/Classes/Public/CDVURLProtocol.m +113 -0
  141. package/src/ios/Classes/Public/CDVUserAgentUtil.h +27 -0
  142. package/src/ios/Classes/Public/CDVUserAgentUtil.m +124 -0
  143. package/src/ios/Classes/Public/CDVViewController.h +92 -0
  144. package/src/ios/Classes/Public/CDVViewController.m +821 -0
  145. package/src/ios/Classes/Public/CDVWebViewEngineProtocol.h +42 -0
  146. package/src/ios/Classes/Public/CDVWhitelist.h +34 -0
  147. package/src/ios/Classes/Public/CDVWhitelist.m +285 -0
  148. package/src/ios/Classes/Public/NSDictionary+CordovaPreferences.h +35 -0
  149. package/src/ios/Classes/Public/NSDictionary+CordovaPreferences.m +63 -0
  150. package/src/ios/Classes/Public/NSMutableArray+QueueAdditions.h +29 -0
  151. package/src/ios/Classes/Public/NSMutableArray+QueueAdditions.m +58 -0
  152. package/src/ios/Cordova/Cordova.h +51 -0
  153. package/src/ios/Cordova/Info.plist +24 -0
  154. package/src/ios/Podfile +5 -0
  155. package/src/ios/SitumCordovaPlugin.xcodeproj/project.pbxproj +1324 -0
  156. package/src/ios/SitumCordovaPlugin.xcodeproj/project.xcworkspace/contents.xcworkspacedata +7 -0
  157. package/src/ios/SitumCordovaPlugin.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist +8 -0
  158. package/src/ios/SitumCordovaPlugin.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings +8 -0
  159. package/src/ios/SitumCordovaPlugin.xcodeproj/xcshareddata/xcschemes/CordovaLib.xcscheme +100 -0
  160. package/src/ios/SitumCordovaPlugin.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist +8 -0
  161. package/src/ios/SitumCordovaPlugin_Prefix.pch +22 -0
  162. package/src/ios/VERSION +1 -0
  163. package/src/ios/cordova.js +2432 -0
  164. package/src/ios/situmcordovaplugin/AppDelegate.h +22 -0
  165. package/src/ios/situmcordovaplugin/AppDelegate.m +98 -0
  166. package/src/ios/situmcordovaplugin/Assets.xcassets/AppIcon.appiconset/Contents.json +98 -0
  167. package/src/ios/situmcordovaplugin/Base.lproj/LaunchScreen.storyboard +25 -0
  168. package/src/ios/situmcordovaplugin/Base.lproj/Main.storyboard +24 -0
  169. package/src/ios/situmcordovaplugin/Constants.h +14 -0
  170. package/src/ios/situmcordovaplugin/Constants.m +14 -0
  171. package/src/ios/situmcordovaplugin/Info.plist +45 -0
  172. package/src/ios/situmcordovaplugin/SITUtils.h +7 -0
  173. package/src/ios/situmcordovaplugin/SITUtils.m +13 -0
  174. package/src/ios/situmcordovaplugin/SitumLocationWrapper.h +109 -0
  175. package/src/ios/situmcordovaplugin/SitumLocationWrapper.m +983 -0
  176. package/src/ios/situmcordovaplugin/SitumPlugin.h +41 -0
  177. package/src/ios/situmcordovaplugin/SitumPlugin.m +752 -0
  178. package/src/ios/situmcordovaplugin/ViewController.h +15 -0
  179. package/src/ios/situmcordovaplugin/ViewController.m +29 -0
  180. package/src/ios/situmcordovaplugin/main.m +16 -0
  181. package/src/ios/situmcordovaplugin/situmcordovaplugin.xcdatamodeld/.xccurrentversion +8 -0
  182. package/src/ios/situmcordovaplugin/situmcordovaplugin.xcdatamodeld/situmcordovaplugin.xcdatamodel/contents +4 -0
  183. package/src/ios/situmcordovaplugintests/AngleTests.m +53 -0
  184. package/src/ios/situmcordovaplugintests/BoundTests.m +51 -0
  185. package/src/ios/situmcordovaplugintests/BuildingTests.m +41 -0
  186. package/src/ios/situmcordovaplugintests/CartesianCoordinateTests.m +42 -0
  187. package/src/ios/situmcordovaplugintests/ConversionAreaTests.m +43 -0
  188. package/src/ios/situmcordovaplugintests/CoordinateTests.m +42 -0
  189. package/src/ios/situmcordovaplugintests/DimensionTests.m +43 -0
  190. package/src/ios/situmcordovaplugintests/EventTests.m +42 -0
  191. package/src/ios/situmcordovaplugintests/FloorTests.m +52 -0
  192. package/src/ios/situmcordovaplugintests/Info.plist +38 -0
  193. package/src/ios/situmcordovaplugintests/InputTests/DirectionsRequestTest.m +108 -0
  194. package/src/ios/situmcordovaplugintests/InputTests/InputCartesianCoordinateTests.m +45 -0
  195. package/src/ios/situmcordovaplugintests/InputTests/InputCoordinateTests.m +45 -0
  196. package/src/ios/situmcordovaplugintests/InputTests/InputFloorTests.m +59 -0
  197. package/src/ios/situmcordovaplugintests/InputTests/InputIndicationTests.m +45 -0
  198. package/src/ios/situmcordovaplugintests/InputTests/InputLocationTests.m +163 -0
  199. package/src/ios/situmcordovaplugintests/InputTests/InputPoiCategoryTests.m +46 -0
  200. package/src/ios/situmcordovaplugintests/InputTests/InputPointTests.m +137 -0
  201. package/src/ios/situmcordovaplugintests/InputTests/LocationRequestTest.m +79 -0
  202. package/src/ios/situmcordovaplugintests/LocationStatusTests.m +60 -0
  203. package/src/ios/situmcordovaplugintests/LocationTests.m +114 -0
  204. package/src/ios/situmcordovaplugintests/NavigationProgressTests.m +50 -0
  205. package/src/ios/situmcordovaplugintests/PoiCategoryIconTests.m +43 -0
  206. package/src/ios/situmcordovaplugintests/PoiCategoryTests.m +42 -0
  207. package/src/ios/situmcordovaplugintests/PoiTests.m +83 -0
  208. package/src/ios/situmcordovaplugintests/PointTests.m +107 -0
  209. package/src/ios/situmcordovaplugintests/RouteStepTests.m +78 -0
  210. package/src/ios/situmcordovaplugintests/RouteTests.m +42 -0
  211. package/src/ios/situmcordovaplugintests/SitumCreatorTests.h +91 -0
  212. package/src/ios/situmcordovaplugintests/SitumCreatorTests.m +928 -0
  213. package/src/ios/situmcordovaplugintests/TestingHelper.h +48 -0
  214. package/src/ios/situmcordovaplugintests/TestingHelper.m +342 -0
  215. package/src/ios/situmcordovaplugintests/indicationTests.m +43 -0
  216. package/tests/common-resources/angle/angle1.json +6 -0
  217. package/tests/common-resources/angle/angle2.json +6 -0
  218. package/tests/common-resources/bounds/bounds1.json +18 -0
  219. package/tests/common-resources/bounds/bounds2.json +18 -0
  220. package/tests/common-resources/building/building1.json +64 -0
  221. package/tests/common-resources/cartesianCoordinate/cartesianCoordinate1.json +4 -0
  222. package/tests/common-resources/circle/circle1.json +17 -0
  223. package/tests/common-resources/coordinate/coordinate1.json +4 -0
  224. package/tests/common-resources/dimensions/dimensions1.json +4 -0
  225. package/tests/common-resources/directionsRequest/directionsRequest1.json +166 -0
  226. package/tests/common-resources/directionsRequest/directionsRequest2.json +167 -0
  227. package/tests/common-resources/directionsRequest/directionsRequest3.json +166 -0
  228. package/tests/common-resources/directionsRequest/directionsRequest4.json +166 -0
  229. package/tests/common-resources/directionsRequest/directionsRequest5.json +167 -0
  230. package/tests/common-resources/directionsRequest/directionsRequest6.json +153 -0
  231. package/tests/common-resources/events/event1.json +66 -0
  232. package/tests/common-resources/floor/floor1.json +13 -0
  233. package/tests/common-resources/floor/floor2.json +13 -0
  234. package/tests/common-resources/indication/indication1.json +10 -0
  235. package/tests/common-resources/location/location1.json +48 -0
  236. package/tests/common-resources/location/location10.json +48 -0
  237. package/tests/common-resources/location/location2.json +48 -0
  238. package/tests/common-resources/location/location3.json +48 -0
  239. package/tests/common-resources/location/location4.json +48 -0
  240. package/tests/common-resources/location/location5.json +48 -0
  241. package/tests/common-resources/location/location6.json +48 -0
  242. package/tests/common-resources/location/location7.json +48 -0
  243. package/tests/common-resources/location/location8.json +48 -0
  244. package/tests/common-resources/location/location9.json +48 -0
  245. package/tests/common-resources/locationRequest/locationRequest1.json +6 -0
  246. package/tests/common-resources/locationRequest/locationRequest2.json +32 -0
  247. package/tests/common-resources/locationRequest/locationRequest3.json +33 -0
  248. package/tests/common-resources/locationRequest/locationRequest4.json +31 -0
  249. package/tests/common-resources/locationStatus/locationStatus1.json +4 -0
  250. package/tests/common-resources/locationStatus/locationStatus10.json +4 -0
  251. package/tests/common-resources/locationStatus/locationStatus11.json +4 -0
  252. package/tests/common-resources/locationStatus/locationStatus12.json +4 -0
  253. package/tests/common-resources/locationStatus/locationStatus13.json +4 -0
  254. package/tests/common-resources/locationStatus/locationStatus2.json +4 -0
  255. package/tests/common-resources/locationStatus/locationStatus3.json +4 -0
  256. package/tests/common-resources/locationStatus/locationStatus4.json +4 -0
  257. package/tests/common-resources/locationStatus/locationStatus5.json +4 -0
  258. package/tests/common-resources/locationStatus/locationStatus6.json +4 -0
  259. package/tests/common-resources/locationStatus/locationStatus7.json +4 -0
  260. package/tests/common-resources/locationStatus/locationStatus8.json +4 -0
  261. package/tests/common-resources/locationStatus/locationStatus9.json +4 -0
  262. package/tests/common-resources/navigationProgress/navigationProgress1.json +77 -0
  263. package/tests/common-resources/navigationProgress/navigationProgress2.json +77 -0
  264. package/tests/common-resources/poi/poi1.json +35 -0
  265. package/tests/common-resources/poi/poi2.json +35 -0
  266. package/tests/common-resources/poi/poi3.json +35 -0
  267. package/tests/common-resources/poi/poi4.json +38 -0
  268. package/tests/common-resources/poi/poi5.json +35 -0
  269. package/tests/common-resources/poiCategory/poiCategory1.json +7 -0
  270. package/tests/common-resources/poiCategoryIcon/poiCategoryIcon1.json +1 -0
  271. package/tests/common-resources/poiCategoryIcon/poiCategoryIcon1.png +0 -0
  272. package/tests/common-resources/point/point1.json +14 -0
  273. package/tests/common-resources/point/point2.json +14 -0
  274. package/tests/common-resources/point/point3.json +14 -0
  275. package/tests/common-resources/point/point4.json +14 -0
  276. package/tests/common-resources/point/point5.json +14 -0
  277. package/tests/common-resources/point/point6.json +14 -0
  278. package/tests/common-resources/point/point7.json +14 -0
  279. package/tests/common-resources/point/point8.json +14 -0
  280. package/tests/common-resources/route/route1.json +530 -0
  281. package/tests/common-resources/routeStep/routeStep1.json +35 -0
  282. package/tests/common-resources/routeStep/routeStep2.json +35 -0
  283. package/tests/common-resources/routeStep/routeStep3.json +35 -0
  284. package/tests/common-resources/routeStep/routeStep4.json +35 -0
  285. package/tests/common-resources/routeStep/routeStep5.json +35 -0
  286. package/tests/common-resources/situmConversionArea/situmConversionArea1.json +19 -0
  287. package/tests/js/resources/fetchBuildings.json +176 -0
  288. package/tests/js/resources/fetchEventsFromBuilding.json +201 -0
  289. package/tests/js/resources/fetchFloorsFromBuilding.json +34 -0
  290. package/tests/js/resources/fetchIndoorPOIsFromBuilding.json +574 -0
  291. package/tests/js/resources/fetchMapFromFloor.json +3 -0
  292. package/tests/js/resources/fetchOutdoorPOIsFromBuilding.json +68 -0
  293. package/tests/js/resources/fetchPoiCategories.json +72 -0
  294. package/tests/js/resources/fetchPoiCategoryIconNormal.json +3 -0
  295. package/tests/js/resources/fetchPoiCategoryIconSelected.json +3 -0
  296. package/tests/js/resources/requestDirections.json +1167 -0
  297. package/tests/js/resources/startPositioning/0_starting.json +4 -0
  298. package/tests/js/resources/startPositioning/1_preparingPositioningModel.json +4 -0
  299. package/tests/js/resources/startPositioning/2_startingPositioning.json +4 -0
  300. package/tests/js/resources/startPositioning/3_calculating.json +4 -0
  301. package/tests/js/resources/startPositioning/4_position.json +48 -0
  302. package/tests/js/resources/startPositioning/5_position.json +48 -0
  303. package/tests/js/test.js +416 -0
  304. package/tests/scripts/clean_android_resources.sh +3 -0
  305. package/tests/scripts/clean_ios_resources.sh +3 -0
  306. package/tests/scripts/copy_android_resources.sh +3 -0
  307. package/tests/scripts/copy_ios_resources.sh +3 -0
  308. package/tests/scripts/self-destruct.sh +1 -0
  309. package/www/android/Interfaces.js +742 -0
  310. package/www/android/situm.js +296 -0
  311. package/www/ios/situm.js +99 -0
  312. package/www/map-view-controller.js +223 -0
  313. package/www/map-view.js +88 -0
@@ -0,0 +1,825 @@
1
+
2
+
3
+ <!DOCTYPE html>
4
+ <html lang="en">
5
+ <head>
6
+ <meta charset="utf-8">
7
+ <title>Source: android/Interfaces.js | Situm</title>
8
+
9
+ <script src="scripts/prettify/prettify.js"> </script>
10
+ <script src="scripts/prettify/lang-css.js"> </script>
11
+ <!--[if lt IE 9]>
12
+ <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
13
+ <![endif]-->
14
+ <link type="text/css" rel="stylesheet" href="styles/bootstrap.min.css">
15
+ <link type="text/css" rel="stylesheet" href="styles/prettify-jsdoc.css">
16
+ <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
17
+ <link type="text/css" rel="stylesheet" href="styles/tui-doc.css">
18
+
19
+
20
+
21
+ <link type="text/css" rel="stylesheet" href="styles/custom.css">
22
+
23
+
24
+ </head>
25
+ <body>
26
+ <nav class="lnb" id="lnb">
27
+ <div class="logo" style="width: 90px; height: 90px">
28
+
29
+ <a href="https://github.com/situmtech/situm-cordova-plugin" rel="noopener noreferrer" target="_blank">
30
+ <img src="https://situm.com/wp-content/uploads/2023/04/situm_logo_blanco_300_sq.png" width="100%" height="100%">
31
+ </a>
32
+
33
+ </div>
34
+ <div class="title">
35
+ <h1><a href="index.html" class="link">Situm</a></h1>
36
+
37
+ </div>
38
+ <div class="search-container" id="search-container">
39
+ <input type="text" placeholder="Search">
40
+ <ul></ul>
41
+ </div>
42
+
43
+ <div class="lnb-api hidden"><h3>Namespaces</h3><ul><li><a href="MapView.html">MapView</a><button type="button" class="hidden toggle-subnav btn btn-link"> <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapView_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapView.html#.onLoad">onLoad</a></li></ul></div></li><li><a href="MapViewControllerImpl.html">MapViewControllerImpl</a><button type="button" class="hidden toggle-subnav btn btn-link"> <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="MapViewControllerImpl_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="MapViewControllerImpl.html#selectPoi">selectPoi</a></li></ul></div></li><li><a href="Situm.html">Situm</a><button type="button" class="hidden toggle-subnav btn btn-link"> <span class="glyphicon glyphicon-plus"></span></button><div class="hidden" id="Situm_sub"><div class="member-type">Methods</div><ul class="inner"><li><a href="Situm.html#.fetchBuildingInfo">fetchBuildingInfo</a></li><li><a href="Situm.html#.fetchBuildings">fetchBuildings</a></li><li><a href="Situm.html#.fetchEventsFromBuilding">fetchEventsFromBuilding</a></li><li><a href="Situm.html#.fetchFloorsFromBuilding">fetchFloorsFromBuilding</a></li><li><a href="Situm.html#.fetchGeofencesFromBuilding">fetchGeofencesFromBuilding</a></li><li><a href="Situm.html#.fetchIndoorPOIsFromBuilding">fetchIndoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchMapFromFloor">fetchMapFromFloor</a></li><li><a href="Situm.html#.fetchOutdoorPOIsFromBuilding">fetchOutdoorPOIsFromBuilding</a></li><li><a href="Situm.html#.fetchPoiCategories">fetchPoiCategories</a></li><li><a href="Situm.html#.fetchPoiCategoryIconNormal">fetchPoiCategoryIconNormal</a></li><li><a href="Situm.html#.fetchPoiCategoryIconSelected">fetchPoiCategoryIconSelected</a></li><li><a href="Situm.html#.internalSetEventDelegate">internalSetEventDelegate</a></li><li><a href="Situm.html#.invalidateCache">invalidateCache</a></li><li><a href="Situm.html#.onEnterGeofences">onEnterGeofences</a></li><li><a href="Situm.html#.onExitGeofences">onExitGeofences</a></li><li><a href="Situm.html#.removeNavigationUpdates">removeNavigationUpdates</a></li><li><a href="Situm.html#.removeRealTimeUpdates">removeRealTimeUpdates</a></li><li><a href="Situm.html#.requestDirections">requestDirections</a></li><li><a href="Situm.html#.requestNavigationUpdates">requestNavigationUpdates</a></li><li><a href="Situm.html#.requestRealTimeUpdates">requestRealTimeUpdates</a></li><li><a href="Situm.html#.setApiKey">setApiKey</a></li><li><a href="Situm.html#.setCacheMaxAge">setCacheMaxAge</a></li><li><a href="Situm.html#.setUserPass">setUserPass</a></li><li><a href="Situm.html#.startPositioning">startPositioning</a></li><li><a href="Situm.html#.stopPositioning">stopPositioning</a></li><li><a href="Situm.html#.updateNavigationWithLocation">updateNavigationWithLocation</a></li></ul></div></li></ul></div><div class="lnb-api hidden"><h3>Global</h3><ul><li><a href="global.html#Angle">Angle</a></li><li><a href="global.html#BeaconFilter">BeaconFilter</a></li><li><a href="global.html#Bounds">Bounds</a></li><li><a href="global.html#Building">Building</a></li><li><a href="global.html#BuildingInfo">BuildingInfo</a></li><li><a href="global.html#CartesianCoordinate">CartesianCoordinate</a></li><li><a href="global.html#Circle">Circle</a></li><li><a href="global.html#Coordinate">Coordinate</a></li><li><a href="global.html#Dimensions">Dimensions</a></li><li><a href="global.html#DirectionsOptions">DirectionsOptions</a></li><li><a href="global.html#DirectionsRequest">DirectionsRequest</a></li><li><a href="global.html#Floor">Floor</a></li><li><a href="global.html#Geofence">Geofence</a></li><li><a href="global.html#Indication">Indication</a></li><li><a href="global.html#Location">Location</a></li><li><a href="global.html#LocationOptions">LocationOptions</a></li><li><a href="global.html#LocationRequest">LocationRequest</a></li><li><a href="global.html#LocationStatus">LocationStatus</a></li><li><a href="global.html#NavigationProgress">NavigationProgress</a></li><li><a href="global.html#NavigationRequest">NavigationRequest</a></li><li><a href="global.html#OutdoorLocationOptions">OutdoorLocationOptions</a></li><li><a href="global.html#POI">POI</a></li><li><a href="global.html#PoiCategory">PoiCategory</a></li><li><a href="global.html#Point">Point</a></li><li><a href="global.html#RealTimeData">RealTimeData</a></li><li><a href="global.html#RealTimeRequest">RealTimeRequest</a></li><li><a href="global.html#Route">Route</a></li><li><a href="global.html#RouteSegment">RouteSegment</a></li><li><a href="global.html#RouteStep">RouteStep</a></li><li><a href="global.html#SitumConversionArea">SitumConversionArea</a></li><li><a href="global.html#SitumEvent">SitumEvent</a></li></ul></div>
44
+ </nav>
45
+ <div id="resizer"></div>
46
+
47
+ <div class="main" id="main">
48
+
49
+
50
+
51
+
52
+
53
+ <section>
54
+ <article>
55
+ <pre class="prettyprint source linenums"><code>/** @name
56
+ * Building
57
+ * @description
58
+ * A Building object definition
59
+ * @property {string} buildingIdentifier - The unique identifier of the resource
60
+ * @property {string} name - The building name that is appropriate for display to the user.
61
+ * @property {string} address - Te building address.
62
+ * @property {Bounds} bounds - Compute corners of this building, without rotation, in earth coordinates.
63
+ * @property {Bounds} boundsRotated - Compute corners of this building, with rotation, in earth coordinates.
64
+ * @property {Coordinate} center - Center of the building's base, as geographical coordinate.
65
+ * @property {Dimensions} Dimensions - Dimensions of building's base (height and width) in meters.
66
+ * @property {string} infoHtml - Additional information about building, formatted with HTML
67
+ * @property {string} pictureThumbUrl - The URL of building thumbnail image
68
+ * @property {string} pictureUrl - The URL of building image
69
+ * @property {number} rotation - Rotation angle of the building's base, relative to the west-east axis, increasing in counter-clockwise, being 0 the west-east axis.
70
+ * @property {string} userIdentifier - Unique identifier of the owner user of the building
71
+ * @property {object} customFields - Map of custom fields, indexed by their name.
72
+ */
73
+
74
+ var Building = {
75
+ buildingIdentifier,
76
+ name,
77
+ address,
78
+ bounds,
79
+ boundsRotated,
80
+ center,
81
+ dimensions,
82
+ infoHtml,
83
+ pictureThumbUrl,
84
+ pictureUrl,
85
+ rotation,
86
+ userIdentifier,
87
+ customFields
88
+ }
89
+
90
+ module.exports = Building
91
+
92
+ /** @name
93
+ * BuildingInfo
94
+ * @description
95
+ * Detailed information of a building in a single object.
96
+ * @property {Building} building - Basic information.
97
+ * @property {Array&lt;Floor>} floors - complete set of levels.
98
+ * @property {Array&lt;Poi>} indoorPois - list of indoor pois (the ones which its coordinate is inside the building).
99
+ * @property {Array&lt;Poi>} outdoorPois - list of indoor pois (the ones which its coordinate is outside the building).
100
+ * @property {Array&lt;Event>} events - list of events associated with a building.
101
+ */
102
+
103
+ var BuildingInfo = {
104
+ building,
105
+ floors,
106
+ indoorPois,
107
+ outdoorPois,
108
+ events
109
+ }
110
+
111
+ module.exports = BuildingInfo
112
+
113
+ /**
114
+ * @name
115
+ * Floor
116
+ * @description
117
+ * Floor of a building.
118
+ * @property {number} altitude - Altitude of the floor above ground level, in meters.
119
+ * @property {string} buildingIdentifier - The identifier of building which this floor belongs.
120
+ * @property {number} level - The number of the floor.
121
+ * @property {string} name - The name of the floor
122
+ * @property {string} mapUrl - The floor map image url
123
+ * @property {number} scale - The scale of the floor image, in px/meters
124
+ * @property {string} floorIdentifier - The unique identifier of the resource
125
+ */
126
+
127
+ var Floor = {
128
+ altitude,
129
+ buildingIdentifier,
130
+ level,
131
+ mapUrl,
132
+ scale,
133
+ floorIdentifier
134
+ }
135
+
136
+ module.exports = Floor
137
+
138
+ /** @name
139
+ * Dimensions
140
+ * @description
141
+ * Define 2D dimensions of a rectangular area.
142
+ * @property {number} width - Width of rectangle in meters
143
+ * @property {number} height - Height of rectangle in meters.
144
+ */
145
+
146
+ var Dimensions = {
147
+ width,
148
+ height
149
+ }
150
+
151
+ module.exports = Dimensions
152
+
153
+ /** @name
154
+ * Bounds
155
+ * @description
156
+ * Represents a rectangle bounds in a greographic 2D space.
157
+ * @property {Coordinate} northEast - The coordinate of the north-east corner of the bound.
158
+ * @property {Coordinate} northWest - The coordinate of the north-west corner of the bound.
159
+ * @property {Coordinate} southEast - The coordinate of the south-east corner of the bound.
160
+ * @property {Coordinate} southWest - The coordinate of the south-east corner of the bound.
161
+ */
162
+
163
+ var Bounds = {
164
+ northEast,
165
+ northWest,
166
+ southEast,
167
+ southWest
168
+ }
169
+
170
+ module.exports = Bounds
171
+
172
+ /**
173
+ * @name
174
+ * Coordinate
175
+ * @description
176
+ * A structure that contains geographical coordinate.
177
+ * @property {number} latitude - Latitude in degrees
178
+ * @property {number} longitude - Longitude in degrees
179
+ */
180
+
181
+ var Coordinate = {
182
+ latitude,
183
+ longitude
184
+ }
185
+
186
+ module.exports = Coordinate
187
+
188
+ /**
189
+ * @name
190
+ * CartesianCoordinate
191
+ * @description
192
+ * A structure that contains cartesian coordinate.
193
+ * @property {number} x - Value of coordinate at x-axis
194
+ * @property {number} y - Value of coordinate at y-axis
195
+ */
196
+
197
+ var CartesianCoordinate = {
198
+ x,
199
+ y
200
+ }
201
+
202
+ module.exports = CartesianCoordinate
203
+
204
+ /**
205
+ * @name
206
+ * POI
207
+ * @description
208
+ * Point of Interest, associated to a building, regardless of whether it's place inside or outside the building.
209
+ * @property {string} identifier - The unique identifier of the resource
210
+ * @property {string} buildingIdentifier - Identifier of building to which the POI belongs.
211
+ * @property {CartesianCoordinate} cartesianCoordinate - Cartesian coordinate of this position, relative to building {@link Bounds}.
212
+ * @property {Coordinate} coordinate - Geographical coordinate of this position
213
+ * @property {string} floorIdentifier - If this POI is outside the building (isOutdoor == true), this field has no meaning.
214
+ * @property {string} poiName - A name for the POI, appropriate for display to the user.
215
+ * @property {Point} position - {@link Point} where the point is located.
216
+ * @property {boolean} isIndoor - Whether the POI is placed outside the building or not.
217
+ * @property {boolean} isOutdoor - Whether the POI is placed outside the building or not.
218
+ * @property {PoiCategory} category - Category of the POI
219
+ * @property {string} infoHtml - Additional information about POI, in HTML
220
+ * @property {object} customFields - Map of custom fields, indexed by their name.
221
+ */
222
+
223
+ var Poi = {
224
+ identifier,
225
+ buildingIdentifier,
226
+ cartesianCoordinate,
227
+ coordinate,
228
+ floorIdentifier,
229
+ poiName,
230
+ position,
231
+ isIndoor,
232
+ isOutdoor,
233
+ category,
234
+ infoHtml,
235
+ customFields
236
+ }
237
+
238
+ module.exports = Poi
239
+
240
+ /**
241
+ * @name
242
+ * Geofence
243
+ * @description
244
+ * Point of Interest, associated to a building, regardless of whether it's place inside or outside the building.
245
+ * @property {string} identifier - The unique identifier of the resource
246
+ * @property {string} buildingIdentifier - Identifier of building to which the POI belongs.
247
+ * @property {string} floorIdentifier - If this POI is outside the building (isOutdoor == true), this field has no meaning.
248
+ * @property {string} name - A name for the geofence, appropriate for display to the user.
249
+ * @property {string} infoHtml - Additional information about POI, in HTML
250
+ * @property {Point[]} polygonPoints - List of points of that define the area of the geofence
251
+ * @property {object} customFields - Map of custom fields, indexed by their name.
252
+ */
253
+
254
+ var Geofence = {
255
+ identifier,
256
+ buildingIdentifier,
257
+ floorIdentifier,
258
+ infoHtml,
259
+ polygonPoints,
260
+ customFields
261
+ }
262
+
263
+ module.exports = Geofence
264
+
265
+ /**
266
+ * @name
267
+ * PoiCategory
268
+ * @description
269
+ * Category of Point of Interest.
270
+ * @property {string} poiCategoryCode - Unique code of the category
271
+ * @property {string} poiCategoryName - The category name appropriate for display to the user
272
+ * @property {string} icon_selected - The selected icon url
273
+ * @property {string} icon_unselected - The unselected icon url
274
+ * @property {boolean} public - Whether the category is public or not
275
+ */
276
+
277
+
278
+ var PoiCategory = {
279
+ poiCategoryCode,
280
+ poiCategoryName,
281
+ icon_selected,
282
+ icon_unselected,
283
+ public
284
+ }
285
+
286
+ module.exports = PoiCategory
287
+
288
+ /**
289
+ * @name
290
+ * Point
291
+ * @description
292
+ * Associate geographical coordinate (Location) with Building and Floor (Cartography) and cartesian coordinate relative to that building.
293
+ * @property {string} buildingIdentifier - Unique identifier for the building to which this point belongs
294
+ * @property {CartesianCoordinate} cartesianCoordinate - Cartesian coordinate (in meters) relative to the Bounds of building's base.
295
+ * @property {Coordinate} coordinate - Geographic coordinate (latitude, longitude) of the point, regardless of whether it's placed inside or outside the building.
296
+ * @property {string} floorIdentifier - Floor identifier (inside the building) where this point is placed.
297
+ * @property {boolean} isIndoor - If the POI is inside the building.
298
+ * @property {boolean} idOutdoor - If the POI is outside the building.
299
+ */
300
+
301
+ var Point = {
302
+ buildingIdentifier,
303
+ cartesianCoordinate,
304
+ coordinate,
305
+ floorIdentifier,
306
+ isIndoor,
307
+ isOutdoor
308
+ }
309
+
310
+ module.exports = Point
311
+
312
+ /**
313
+ * @name
314
+ * Location
315
+ * @description
316
+ * A location. It can be indoor or outdoor, check isIndoor and isOutdoor. A valid indoor location has floorIdentifier and cartesianCoordinate.
317
+ * @property {number} accuracy - The accuracy radius (in meters)
318
+ * @property {Angle} bearing - The bearing (in degrees) with respect to the Earth North.
319
+ * @property {string} bearingQuality - The quality of the cartesian bearing.
320
+ * @property {string} buildingIdentifier - Only used in indoor.
321
+ * @property {Angle} cartesianBearing - Only used in indoor. In {@link Angle} object.
322
+ * @property {CartesianCoordinate} cartesianCoordinate - Only used in indoor. In {@link CartesianCoordinate} object.
323
+ * @property {Coordinate} coordinate - The {@link Coordinate} of the location
324
+ * @property {string} floorIdentifier - Only used in indoor.
325
+ * @property {Point} position - The position of the location as {@link Point}.
326
+ * @property {string} provider - The device identifier that has generated the location
327
+ * @property {string} quality - Only used in indoor. Possible values are HIGH and LOW.
328
+ * @property {boolean} hasBearing - True if the location has bearing and the bearing quality is Location.Quality.HIGH, false otherwise.
329
+ * @property {number} timestamp - The timestamp of the location.
330
+ * @property {boolean} hasCartesianBearing - Only used in indoor.
331
+ * @property {boolean} isIndoor - True if the location is indoor
332
+ * @property {boolean} isOutdoor - True if the location is outdoor
333
+ * @property {string} deviceId - Identifier of the device that has generated the location
334
+ */
335
+
336
+ var Location = {
337
+ accuracy,
338
+ bearing,
339
+ bearingQuality,
340
+ buildingIdentifier,
341
+ cartesianBearing,
342
+ cartesianCoordinate,
343
+ coordinate,
344
+ floorIdentifier,
345
+ position,
346
+ provider,
347
+ quality,
348
+ hasBearing,
349
+ timestamp,
350
+ hasCartesianBearing,
351
+ isIndoor,
352
+ isOutdoor,
353
+ deviceId
354
+ }
355
+
356
+ module.exports = Location
357
+
358
+ /**
359
+ * @name
360
+ * LocationStatus
361
+ * @description
362
+ * Status of the positioning
363
+ * @property {string} statusName - Status in which the positioning is
364
+ * @property {number} statusOrdinal - Number of the status
365
+ */
366
+
367
+ var LocationStatus = {
368
+ statusName,
369
+ statusOrdinal
370
+ }
371
+
372
+ module.exports = LocationStatus
373
+
374
+ /**
375
+ * @name
376
+ * Angle
377
+ * @description
378
+ * Representation of an angle.
379
+ * @property {number} degrees - Angle in degrees, increasing in counter-clockwise
380
+ * @property {number} degreesClockwise - Angle in radians, increasing in clockwise
381
+ * @property {number} radians - Angle in radians, increasing in counter-clockwise
382
+ * @property {number} radiansMinusPiPi - Angle in radians in range (-pi,pi)
383
+ */
384
+
385
+ var Angle = {
386
+ degrees,
387
+ degreesClockwise,
388
+ radians,
389
+ radiansMinusPiPi
390
+ }
391
+
392
+ module.exports = Angle
393
+
394
+ /**
395
+ * @name
396
+ * Route
397
+ * @description
398
+ * Route between two points.
399
+ * @property {RouteStep[]} edges - Ordered list of steps to go to the goal point
400
+ * @property {RouteStep} firstStep - First step
401
+ * @property {Point} from - Point where the route starts.
402
+ * @property {Indication} indications - Ordered list of instructions to go to the destination
403
+ * @property {RouteStep} lastStep - Last step
404
+ * @property {Point[]} nodes - A collection of points of the route (not ordered)
405
+ * @property {Point[]} points - List of ordered points of the route
406
+ * @property {Point} to - Last point and goal of the route.
407
+ * @property {RouteStep[]} steps - Ordered list of steps to go to the goal point
408
+ * @property {RouteSegment[]} segments - List of segments formed by consecutive points and a floor identifier
409
+ */
410
+
411
+ var Route = {
412
+ edges,
413
+ firstStep,
414
+ from,
415
+ indications,
416
+ lastStep,
417
+ nodes,
418
+ points,
419
+ to,
420
+ steps,
421
+ segments
422
+ }
423
+
424
+ module.exports = Route
425
+
426
+ /**
427
+ * @name
428
+ * RouteStep
429
+ * @description
430
+ * A fragment of a route, described by the initial point from and the last point to of the fragment, and some information about the step within the route.
431
+ * @property {number} distance - Distance between from and to in meters.
432
+ * @property {number} distanceToGoal - Distance in meters between the start point of this step (from) and the last point in the route ('to' of the last step).
433
+ * @property {Point} from - Start point of this step.
434
+ * @property {number} id - Position of this RouteStep in the list of steps (Route.steps) of the route to which it belongs.
435
+ * @property {Point} to - End point of this step.
436
+ * @property {boolean} isFirst - Returns true if this is the first step in the route.
437
+ * @property {boolean} isLast - Returns true if this is the last step in the route.
438
+ */
439
+
440
+ var RouteStep = {
441
+ distance,
442
+ distanceToGoal,
443
+ from,
444
+ id,
445
+ to,
446
+ isFirst,
447
+ isLast
448
+ }
449
+
450
+ module.exports = RouteStep
451
+
452
+ /**
453
+ * @name
454
+ * RouteSegment
455
+ * @description
456
+ * A fragment of a route, described by a floor identifier and a list of consecutive points from the same floor
457
+ * @property {string} floorIdentifier - Identifier of the floor containing the points in this segment
458
+ * @property {Point[]} points - Consecutive points in the same floor forming a path
459
+ */
460
+
461
+ var RouteSegment = {
462
+ floorIdentifier,
463
+ points
464
+ }
465
+
466
+ module.exports = RouteSegment
467
+
468
+ /**
469
+ * @name
470
+ * Indication
471
+ * @description
472
+ * Represents the instruction that a user should follow when on a RouteStep to continue the route.
473
+ * @property {number} distance - The distance between the origin and destination
474
+ * @property {number} distanceToNextLevel - The number of levels between the origin and destination
475
+ * @property {string} indicationType - The Indication.Action of the instruction as String
476
+ * @property {number} orientation - The angle a user should change his direction in order to go from the origin to the destination.
477
+ * @property {string} orientationType - The Indication.Orientation of the instruction as String
478
+ * @property {number} stepIdxDestination - The index of the indication's step of destination.
479
+ * @property {number} stepIdxOrigin - The index of the indication's step of origin
480
+ * @property {boolean} neededLevelChange - If the user should change the level in order to arrive to destination
481
+ */
482
+
483
+ var Indication = {
484
+ distance,
485
+ distanceToNextLevel,
486
+ indicationType,
487
+ orientation,
488
+ orientationType,
489
+ stepIdxDestination,
490
+ stepIdxOrigin,
491
+ neededLevelChange
492
+ }
493
+
494
+ module.exports = Indication
495
+
496
+
497
+ /**
498
+ * @name
499
+ * NavigationProgress
500
+ * @description
501
+ * Provides information of the progress of a user while following a route.
502
+ * @property {Point} closestPointInRoute - Closest point in the route from the user location provided . @deprecated Use closestLocationInRoute instead.
503
+ * @property {Location} closestLocationInRoute - Closest location in the route from the user location provided .
504
+ * @property {number} distanceToClosestPointInRoute - Distance between the real user location (provided to updateWithLocation(Location)) and the closest route location.
505
+ * @property {Indication} currentIndication - The current indication.
506
+ * @property {Indication} nextIndication - The next indication.
507
+ * @property {number} currentStepIndex - The index of the closest route step to the user, where closestLocationInRoute is.
508
+ * @property {number} distanceToGoal - The distance in meters from closestLocationInRoute to route's goal point.
509
+ * @property {number} distanceToEndStep - The distance in meters to go from closestLocationInRoute to the end of the current step.
510
+ * @property {number} timeToEndStep - The estimated time to go from closestLocationInRoute to the end of the current route step, considering a speed of 1 meter/second.
511
+ * @property {number} timeToGoal - The estimated time to go from closestLocationInRoute to the goal/end of route, considering a speed of 1 meter/second.
512
+ * @property {RouteStep} routeStep - The closest route step to the user, where closestLocationInRoute is.
513
+ * @property {Point[]} points - List of ordered points of the remaining route
514
+ * @property {RouteSegment[]} segments - List of segments formed by consecutive points and a floor identifier
515
+ */
516
+
517
+ var NavigationProgress = {
518
+ closestPointInRoute,
519
+ closestLocationInRoute,
520
+ distanceToClosestPointInRoute,
521
+ currentIndication,
522
+ nextIndication,
523
+ currentStepIndex,
524
+ distanceToGoal,
525
+ distanceToEndStep,
526
+ timeToEndStep,
527
+ timeToGoal,
528
+ routeStep,
529
+ points,
530
+ segments
531
+ }
532
+
533
+ module.exports = NavigationProgress
534
+
535
+
536
+ /**
537
+ * @name
538
+ * SitumEvent
539
+ * @description
540
+ * An event: POI with radius, conversion area and asociated statistics. It is intended for usage in marketing apps.
541
+ * @property {number} buildingIdentifier - The identifier of the building this floor belongs to. Deprecated, use trigger.center.buildingIdentifier instead
542
+ * @property {number} identifier - Unique identifier of the SitumEvent.
543
+ * @property {number} floorIdentifier - The identifier of the floor this event is located at. @deprecated, use trigger.center.floorIdentifier instead
544
+ * @property {string} infoHtml - Information contained into the event, in HTML format.
545
+ * @property {SitumConversionArea} conversionArea - Location where the event is located. @deprecated, use conversion instead
546
+ * @property {Circle} conversion - Location where the event is located.
547
+ * @property {Circle} trigger - Location where the event should be fired
548
+ * @property {object} customFields - Key-value pairs that allow to extend and fully customize the information associated with the event.
549
+ * @property {number} radius - Radius of the event associated area. @deprecated, use trigger.radius instead
550
+ * @property {string} name - Name of the event
551
+ * @property {number} x - Center of the event in the x-axis. @deprecated, use trigger.center.cartesianCoordinate.x instead
552
+ * @property {number} y - Center of the event in the y-axis. @deprecated, use trigger.center.cartesianCoordinate.y instead
553
+ */
554
+
555
+ var SitumEvent = {
556
+ buildingIdentifier,
557
+ identifier,
558
+ floorIdentifier,
559
+ infoHtml,
560
+ conversionArea,
561
+ customFields,
562
+ radius,
563
+ name,
564
+ x,
565
+ y
566
+ }
567
+
568
+ module.exports = SitumEvent
569
+
570
+ /**
571
+ * @name
572
+ * SitumConversionArea
573
+ * @description
574
+ * A rectangular area of a floor defining the conversion area of an event
575
+ * @property {number} floorIdentifier - The identifier of the floor the SitumConversionArea is located at.
576
+ * @property {object} topLeft - Top-left corner
577
+ * @property {object} topRight - Top-right corner
578
+ * @property {object} bottomLeft - Bottom-left corner
579
+ * @property {object} bottomRight - Bottom-right corner
580
+ */
581
+
582
+ var SitumConversionArea = {
583
+ floorIdentifier,
584
+ topLeft,
585
+ topRight,
586
+ bottomLeft,
587
+ bottomRight,
588
+ }
589
+
590
+ module.exports = Circle
591
+
592
+ /**
593
+ * @name
594
+ * Circle
595
+ * @description
596
+ * A circular area
597
+ * @property {Point} center - The center of the circle
598
+ * @property {number} radius - The radius of the circle
599
+ */
600
+
601
+ var Circle = {
602
+ center,
603
+ radius,
604
+ }
605
+
606
+ module.exports = SitumConversionArea
607
+
608
+ /**
609
+ * @name
610
+ * LocationOptions
611
+ * @description
612
+ * A data object that contains parameters for the location service, LocationManager.
613
+ * @property {number} buildingIdentifier - Identifier of the building on which the positioning will be started
614
+ * @property {number} interval - Default interval (in milliseconds) to notify location updates
615
+ * @property {string} indoorProvider - Default indoor provider. Possible values are INPHONE and SUPPORT
616
+ * @property {boolean} useBle - Defines whether or not to use BLE for positioning
617
+ * @property {boolean} useWifi - Defines whether or not to use Wi-Fi for positioning
618
+ * @property {boolean} useGps - Defines whether or not to use the GPS for indoor positioning
619
+ * @property {boolean} useBarometer - Defines whether or not to use barometer for indoor positioning
620
+ * @property {string} motionMode - Default motion mode. Possible values are BY_CAR, BY_FOOT and RADIOMAX
621
+ * @property {boolean} useForegroundService - Defines whether or not to activate the {@link http://developers.situm.es/pages/android/using_situm_sdk_background.html foreground service}
622
+ * @property {boolean} useDeadReckoning - Defines whether ot not to use dead reckoning to get fast position updates using only the inertial sensors, between the server position updates.
623
+ * @property {OutdoorLocationOptions} outdoorLocationOptions - Outdoor location options. Only used in an indoor/outdoor request
624
+ * @property {BeaconFilter[]} beaconFilters - Beacon filters to be handled during scan time, otherwise only Situm beacons will be scanned. Can be invoked multiple times to add as much beacon filters as you want @deprecated The SitumSDK now does it automatically
625
+ * @property {number} smallestDisplacement - Default smallest displacement to nofiy location updates
626
+ * @property {string} realtimeUpdateInterval - Default interval to send locations to the Realtime. Possible values are REALTIME, FAST, NORMAL, SLOW and BATTERY_SAVER
627
+ * @property {boolean} autoEnableBleDuringPositioning - Set if the BLE should be re-enabled during positioning if the ble is used. Android only
628
+ */
629
+
630
+ var LocationOptions = {
631
+ buildingIdentifier,
632
+ interval,
633
+ indoorProvider,
634
+ useBle,
635
+ useWifi,
636
+ useGps,
637
+ useBarometer,
638
+ motionMode,
639
+ useForegroundService,
640
+ useDeadReckoning,
641
+ outdoorLocationOptions,
642
+ beaconFilters,
643
+ smallestDisplacement,
644
+ realtimeUpdateInterval
645
+ }
646
+
647
+ module.exports = LocationOptions
648
+
649
+ /**
650
+ * @name
651
+ * LocationRequest
652
+ * @description
653
+ * A data object that contains parameters for the location service, LocationManager.
654
+ * @type {array}
655
+ * @property {Building} building 0 - Building on which the positioning will be started
656
+ * @property {LocationOptions} locationOptions 1 - Location options.
657
+ */
658
+
659
+ var LocationRequest = {
660
+ building,
661
+ locationOptions
662
+ }
663
+
664
+ module.exports = LocationRequest
665
+
666
+ /**
667
+ * @name
668
+ * NavigationRequest
669
+ * @description
670
+ * A data object that contains parameters for the navigation service, NavigationManager.
671
+ * @property {number} distanceToChangeIndicationThreshold - Distance threshold from when the next indication is considered reached.
672
+ * @property {number} distanceToFloorChangeThreshold - Distance threshold from when a floor change is considered reached.
673
+ * @property {number} distanceToGoalThreshold - Distance threshold from when the goal is considered reached.
674
+ * @property {number} distanceToIgnoreFirstIndication - Maximum distance to ignore the first indication when navigating a route (Only available for Android).
675
+ * @property {number} ignoreLowQualityLocations - Set if low quality locations should be ignored. (Only available for Android).
676
+ * @property {number} indicationsInterval - Time to wait between indications.
677
+ * @property {number} outsideRouteThreshold - Set the distance to consider the use is outside of the route. A type=userOutsideRoute will be sent trough the NavigationListener .
678
+ * @property {number} roundIndicationsStep - Step that will be used to round indications distance.
679
+ * @property {number} timeToFirstIndication - Time to wait until the first indication is returned.
680
+ * @property {number} timeToIgnoreUnexpectedFloorChanges - Time (in millis) to ignore the locations received during navigation, when the next indication is a floor change, if the locations are in a wrong floor (not in origin or destination floors).
681
+ */
682
+
683
+ var NavigationRequest = {
684
+ distanceToGoalThreshold,
685
+ outsideRouteThreshold,
686
+ distanceToFloorChangeThreshold,
687
+ distanceToChangeIndicationThreshold,
688
+ indicationsInterval,
689
+ timeToFirstIndication,
690
+ roundIndicationsStep,
691
+ timeToIgnoreUnexpectedFloorChanges
692
+ }
693
+
694
+ module.exports = NavigationRequest
695
+
696
+ /**
697
+ * @name
698
+ * DirectionsRequest
699
+ * @description
700
+ * A data object that contains the request for directions.
701
+ * @property {Building} positioningBuilding
702
+ * @property {Point|Location} from - Current user's position as the starting point of the route.
703
+ * @property {Point|POI} to - Point to, where the route should end.
704
+ * @property {DirectionsOptions} options - Options that can be added to the request.
705
+ */
706
+
707
+ var DirectionsRequest = {
708
+ positioningBuilding,
709
+ from,
710
+ to,
711
+ options
712
+ }
713
+
714
+ module.exports = DirectionsRequest
715
+
716
+ /**
717
+ * @name
718
+ * DirectionsOptions
719
+ * @description
720
+ * A data object that contains the directions options.
721
+ * @property {boolean} minimizeFloorChanges - Defines wheter or not the route should be calculated minimizing the floor changes even if the result is longer.
722
+ * @property {boolean} accessibleRoute - Defines wheter or not the route has to be suitable for wheel chairs (true) or not (false). @deprecated, use accessibilityMode
723
+ * @property {boolean} accessible - Defines wheter or not the route has to be suitable for wheel chairs (true) or not (false). @deprecated, use accessibilityMode
724
+ * @property {string} accessibilityMode - Defines the accessibility mode of the route. Possible values are: CHOOSE_SHORTEST, ONLY_NOT_ACCESSIBLE_FLOOR_CHANGES, ONLY_ACCESSIBLE
725
+ * @property {number} startingAngle - Current user's orientation in degrees.
726
+ */
727
+
728
+ var DirectionsOptions = {
729
+ minimizeFloorChanges,
730
+ accessibleRoute,
731
+ startingAngle
732
+ }
733
+
734
+ module.exports = DirectionsOptions
735
+
736
+ /**
737
+ * @name
738
+ * OutdoorLocationOptions
739
+ * @description
740
+ * Outdoor location options are only used in indoor-outdoor mode (Only available for Android)
741
+ * @property {boolean} userDefinedThreshold
742
+ * @property {number} computeInterval - Interval (in milliseconds) between consecutive GPS readings performed by Situm SDK, and therefore between consecutive generated Outdoor Locations.
743
+ * @property {number} averageSnrThreshold
744
+ */
745
+
746
+ var OutdoorLocationOptions = {
747
+ userDefinedThreshold,
748
+ computeInterval,
749
+ averageSnrThreshold
750
+ }
751
+
752
+ module.exports = OutdoorLocationOptions
753
+
754
+ /**
755
+ * @name
756
+ * BeaconFilter
757
+ * @description
758
+ * Represents a BLE filter. Now the only field is the BLE proximity UUID
759
+ * @property {string} uuid - Assigns the proximity UUID
760
+ */
761
+
762
+ var BeaconFilter = {
763
+ uuid
764
+ }
765
+
766
+ module.exports = BeaconFilter
767
+
768
+ /**
769
+ * @name
770
+ * RealTimeRequest
771
+ * @description
772
+ * A data object that contains the parameters to process realtime data of the users.
773
+ * @property {Building} building object
774
+ * @property {int} pollTime - Interval in milliseconds (minimum is 3000ms).
775
+ */
776
+
777
+ var RealTimeRequest = {
778
+ building,
779
+ pollTime,
780
+ }
781
+
782
+ module.exports = RealTimeRequest
783
+
784
+ /**
785
+ * @name
786
+ * RealTimeData
787
+ * @description
788
+ * A data object that contains information of the location of users in realtime.
789
+ * @property {Array&lt;Location>} locations object
790
+ */
791
+
792
+ var RealTimeData = {
793
+ locations,
794
+ }
795
+
796
+ module.exports = RealTimeData</code></pre>
797
+ </article>
798
+ </section>
799
+
800
+
801
+
802
+
803
+ </div>
804
+
805
+ <footer>
806
+ <img class="logo" src="https://situm.com/wp-content/uploads/2023/04/situm_logo_blanco_300_sq.png" style="width: 90px; height: 90px">
807
+ <div class="footer-text">COPYRIGHT © SITUM TECHNOLOGIES 2014 - 2018</div>
808
+ </footer>
809
+ <script>prettyPrint();</script>
810
+ <script src="scripts/jquery.min.js"></script>
811
+ <script src="scripts/tui-doc.js"></script>
812
+ <script src="scripts/linenumber.js"></script>
813
+
814
+ <script>
815
+ var id = '_sub'.replace(/"/g, '_');
816
+ var selectedApi = document.getElementById(id); // do not use jquery selector
817
+ var $selectedApi = $(selectedApi);
818
+
819
+ $selectedApi.removeClass('hidden');
820
+ $selectedApi.parent().find('.glyphicon').removeClass('glyphicon-plus').addClass('glyphicon-minus');
821
+ showLnbApi();
822
+ </script>
823
+
824
+ </body>
825
+ </html>