Difference between revisions of "HowTo:Create Image Map Overlays"
| Line 28: | Line 28: | ||
== 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/> | ||
| − | #To ease up the work of the customizer we suggest to derive a new object from the [[SYSCLS FILEDOCUMENT | | + | #To ease up the work of the customizer we suggest to derive a new object from the '''[[SYSCLS FILEDOCUMENT | FILEDOCUMENT]]'''. The properties are visible in the ''[[Class_Details | Class Details]]''. |
| − | #Add the Classification [[SYSCLS_MAPOVERLAY | MapOverlays]] to the new MetaClass by using the [[Relation_Editor | Relation Editor]] | + | #Add the Classification [[SYSCLS_MAPOVERLAY | MapOverlays]] to the new MetaClass by using the [[Relation_Editor | Relation Editor]] |
| − | #Define the required Metaproperties for the [[SYSCLS_MAPOVERLAY | MapOverlays]] | + | #Define the required Metaproperties for the '''[[SYSCLS_MAPOVERLAY | MapOverlays]]''' |
| − | #* HowTo: [[HowTo:Create_a_new_MetaProperty | Create a new MetaProperty]] | + | #*HowTo:[[HowTo:Create_a_new_MetaProperty |Create a new MetaProperty]]<br/>[[File:UI_MetaPropertiesMapOverlay.PNG|990 px|border|alt=View|View]] |
| − | [[File:UI_MetaPropertiesMapOverlay.PNG|990 px|border|alt=View|View]] | + | #Add the required '''[[Metaproperty | MetaPropertys]]''' to the '''[[MetaClass| Meta Class]]'''. |
| − | #Add the required [[Metaproperty | | + | #*HowTo: [[HowTo:Add_a_MetaProperty_to_a_MetaClass | Add a Metaproperty to a Metaclass]]<br/>[[UI_Properties_MapOverlay.PNG|990 px|border|alt=View|View]] |
| − | #* HowTo: [[HowTo:Add_a_MetaProperty_to_a_MetaClass | Add a Metaproperty to a Metaclass]] | + | #Save the object with {{key press|Ctrl|S}} |
| − | # Save the object with {{key press|Ctrl|S}} | + | #Build and Release the Customizing {{key press|F5}} |
| − | # Build and Release the Customizing {{key press|F5}} | + | # Check the Classification in the ''[[Object Explorer | Object Explorer]]'' |
| − | # Check the Classification in the Object Explorer | + | |
== Publish the map overlay == | == Publish the map overlay == | ||
To publish the Image Map Overlay to the UBIK.Android Client it is required to configure the [[Application_Context_Management | ACM]].<br/> | To publish the Image Map Overlay to the UBIK.Android Client it is required to configure the [[Application_Context_Management | ACM]].<br/> | ||
| − | #Create a [[METACLASSSCOPE| METACLASSSCOPE]] for the Image Map Overlay Meta Class<br/> | + | #Create a '''[[METACLASSSCOPE| METACLASSSCOPE]]''' for the Image Map Overlay Meta Class<br/> |
#* HowTo: [[HowTo:Create_a_new_MetaClassScope | Create a Metaclass Scope]]<br/> | #* HowTo: [[HowTo:Create_a_new_MetaClassScope | Create a Metaclass Scope]]<br/> | ||
# Assign the Properties to the Metaclass Scope<br/> | # Assign the Properties to the Metaclass Scope<br/> | ||
#* Required Properties for the ACM: | #* Required Properties for the ACM: | ||
| − | #** WIDTH_METERS | + | #** ''WIDTH_METERS'' |
| − | #** Z_LEVEL | + | #** ''Z_LEVEL'' |
| − | #** ROTATION_CLOCKWISE_DEGREES | + | #** ''ROTATION_CLOCKWISE_DEGREES'' |
| − | #** LOCATION_CENTER | + | #** ''LOCATION_CENTER'' |
| − | #** FILETYPE | + | #** ''FILETYPE'' |
# Add the Metaclassscope to the Context<br/> | # Add the Metaclassscope to the Context<br/> | ||
# Save the object with {{key press|Ctrl|S}} | # Save the object with {{key press|Ctrl|S}} | ||
Revision as of 10:43, 10 July 2015
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.
Basics
To configure the image map overlay two steps are required:
- Georeferencing of the image
- This is necessary to generate the required parameters.
- Prefered Software: | Google Earth
- How to add a map overlay to Google Earth is available there: | Add a Map Overlay (Google How To German)
- Configuration of the Image Map Overlay in UBIK Studio
- The MapOverlys are based on a File Documents, so basicly should contain the properties for the classification Document, Filedocument and MapOverlays
[edit]
GIS Software
There are a lot of 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 small introduction for adding a Map Overlay to Google Earth and capturing the parameters for UBIK Studio.
- Prepare an image map overlay
- The map overlay should be a .png Image of the building scheme.
- Add the map overlay to the basemap
- Tutorial of Google Earth: | Add a Map Overlay (Google How To German)
- 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
- ROTATION_CLOCKWISE_DEGREES: The rotation can be extracted by using the editing tool of Google Earth for image map overlays.
- 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.
 | Please 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:
- To ease up the work of the customizer we suggest to derive a new object from the FILEDOCUMENT. The properties are visible in the Class Details.
- Add the Classification MapOverlays to the new MetaClass by using the Relation Editor
- Define the required Metaproperties for the MapOverlays
- Add the required MetaPropertys to the Meta Class.
- Save the object with Ctrl+S
- Build and Release the Customizing F5
- Check the Classification in the Object Explorer
Publish the map overlay
To publish the Image Map Overlay to the UBIK.Android Client it is required to configure the ACM.
- Create a METACLASSSCOPE for the Image Map Overlay Meta Class
- HowTo: Create a Metaclass Scope
- HowTo: Create a Metaclass Scope
- Assign the Properties to the Metaclass Scope
- Required Properties for the ACM:
- WIDTH_METERS
- Z_LEVEL
- ROTATION_CLOCKWISE_DEGREES
- LOCATION_CENTER
- FILETYPE
- Required Properties for the ACM:
- Add the Metaclassscope to the Context
- Save the object with Ctrl+S
- Release the MetaDefinitions
- 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
- Add a new Object in the Bulk Editor
- Choose the Filetype (PNG)
- Add NAME and DESCRIPTION
- Assign the image in the Bulk editor (FULLPATH)
- Set Is Local? to TRUE
- Save the object with Ctrl+S
