Jump to: navigation, search

Difference between revisions of "HowTo:Create Image Map Overlays"

(→‎Studio)
(→‎Studio)
Line 26: Line 26:
  
 
= Studio =  
 
= Studio =  
−
=== Create a map overlay document ===
+
=== Create a Map Overlay Document ===
 
The following steps are required to create a Map Overlay Document: <br/>
 
The following steps are required to create a Map Overlay Document: <br/>
 
#It is recommended to derive a new [[MetaClass]] from '''[[SYSCLS FILEDOCUMENT | Filedocument]]''' from the ''Custom.Document'' Namespace.
 
#It is recommended to derive a new [[MetaClass]] from '''[[SYSCLS FILEDOCUMENT | Filedocument]]''' from the ''Custom.Document'' Namespace.
Line 38: Line 38:
 
# Check the classification in the ''[[Object Explorer | Object Explorer]]''
 
# Check the classification in the ''[[Object Explorer | Object Explorer]]''
  
−
=== Publish the map overlay ===
+
=== Publish the Map Overlay ===
 
To publish the Image Map Overlay to the {{UBIK Android}} client the [[Application_Context_Management | ACM]] has to be configured:
 
To publish the Image Map Overlay to the {{UBIK Android}} client the [[Application_Context_Management | ACM]] has to be configured:
 
#Create a [[METACLASSSCOPE]] for the Image Map Overlay MetaClass
 
#Create a [[METACLASSSCOPE]] for the Image Map Overlay MetaClass
Line 54: Line 54:
 
# Check the Classification in the ACM Manager
 
# Check the Classification in the ACM Manager
  
−
=== Add an image map overlay ===
+
=== Add an Image Map Overlay ===
 
To add a Map Overlay it is required to take the parameters from the georeferenced Map Overlay Image:
 
To add a Map Overlay it is required to take the parameters from the georeferenced Map Overlay Image:
 
# Create a new object in the {{Bulk Editor}}
 
# Create a new object in the {{Bulk Editor}}
Line 67: Line 67:
 
# Save the object with {{key press|Ctrl|S}}
 
# Save the object with {{key press|Ctrl|S}}
  
 +
=== Add Image Map Overlay to ===
 +
To finally display the image overlay on the client it is necessary to put it right into the application's infrastructure.
 +
# Open [[CONTEXT]] in ''[[Relation Editor | Relation Editor]]''
 +
# Add overlay per drag and drop to ''Infrastructre objects'' ([[SYSREL INFRASTRUCTURE|SYSREL INFRASTRUCTURE]])
 +
# Save the object with {{key press|Ctrl|S}}
 
<headertabs />
 
<headertabs />
  

Revision as of 13:55, 30 March 2016

Image map overlays will be visualized as base maps in the map activity of the client. These are images (.png) that will be vizualized on the right location, with the right scale and also with the right rotation. Therefore georeferencing of the image is required.

Configuration of the image map overlay requires two steps:

  1. Georeferencing of the image
  2. Configuration of the Image Map Overlay in UBIK Studio
[edit]

Georeferencing (GIS Software)

There are many possibilities to georeference a map overlay. For image map overlays Google Earth is the fastest way to extract the required parameters. This How-To is a short introduction for adding a Map Overlay to Google Earth and capturing the parameters for UBIK® Studio.

  1. Prepare an image map overlay
    • The map overlay should be a .png image of the building scheme.
  2. Add the map overlay to the basemap
  3. Extract the required parameters:
    • WIDTH_METERS: The width of the image in meters. Please use the measurement tool of Google Earth: Measuring distances and areas
      View
    • ROTATION_CLOCKWISE_DEGREES: The rotation can be extracted by using the editing tool of Google Earth for image map overlays.
      View
    • LOCATION_CENTER: To extract this parameter it is required to use the Placemark tool of Google Earth and locate the placemark in the center of the image. How to use a placemark tool: Creating a new placemark
      • The location can be extracted by using the editing mode of the placemark.
        View


IC Attention.pngPlease use the Google Earth Show Lat/Long setting with Decimal Degrees [HowTo: Viewing preferences].

Studio

Create a Map Overlay Document

The following steps are required to create a Map Overlay Document:

  1. It is recommended to derive a new MetaClass from Filedocument from the Custom.Document Namespace.
  2. Add the classification MapOverlays to the new MetaClass using the Relation Editor.
  3. Prepare the required MetaProperties for the MapOverlays classification.
  4. Add the required MetaProperties to the MetaClass.
  5. Save the object with Ctrl+S
  6. Build and release the customizing F5
  7. Check the classification in the Object Explorer

Publish the Map Overlay

To publish the Image Map Overlay to the UBIK® Android client the ACM has to be configured:

  1. Create a METACLASSSCOPE for the Image Map Overlay MetaClass
  2. Assign the Properties to the Scope
    • Required Properties within the ACM:
      • WIDTH_METERS
      • Z_LEVEL
      • ROTATION_CLOCKWISE_DEGREES
      • LOCATION_CENTER
      • FILETYPE
  3. Relate the MetaClassCcope to the according CONTEXT
  4. Save the object with Ctrl+S
  5. Release the MetaDefinitions
  6. Check the Classification in the ACM Manager

Add an Image Map Overlay

To add a Map Overlay it is required to take the parameters from the georeferenced Map Overlay Image:

  1. Create a new object in the Bulk Editor
    • Choose the Filetype (PNG)
    • Set a Name and Description
    • Select the image in the Bulk Editor (FULLPATH)
    • Set Is Local to TRUE
    • Set the Location Center by filling out the Geo Property
      View
    • Set the Rotation Clockwise Degree
    • Set the Width (in Meters)
    • Set the Z-Level (Default: 0)
  2. Save the object with Ctrl+S

Add Image Map Overlay to

To finally display the image overlay on the client it is necessary to put it right into the application's infrastructure.

  1. Open CONTEXT in Relation Editor
  2. Add overlay per drag and drop to Infrastructre objects (SYSREL INFRASTRUCTURE)
  3. Save the object with Ctrl+S

See also

Retrieved from "https://wiki.augmensys.com/index.php?title=HowTo:Create_Image_Map_Overlays&oldid=18994"