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 Configuration of the image map overlay requires two steps are required:<br/>
# '''Georeferencing of the image'''
#* This is necessary to generate the required parameters.
#* Prefered Software: [http://www.google.com/earth/download/ge/agree.html | Google Earth]#* How to add a map overlay to Google Earth is available there: under [https://support.google.com/earth/answer/148099#createoverlay | Add a Map Overlay (Google How To German)]
# '''Configuration of the Image Map Overlay in UBIK Studio'''
#* The MapOverlys Map Overlays objects are based on a File Documentsfile documents, so basicly should contain the hence must implement properties for of the classification classifications [[SYSCLS DOCUMENT | Document]], [[SYSCLS FILEDOCUMENT | Filedocument]] and [[SYSCLS_MAPOVERLAY | MapOverlays]]
= Georeferencing (GIS Software ) =There are a lot of many possibilities to georeference a map overlay. For image map overlays [http://www.google.com/earth/download/ge/agree.html | Google Earth] is the fastest way to extract the required parameters.This How -To is a small short 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 image of the building scheme.
# Add the map overlay to the basemap
#* Tutorial of Google Earth: [https://support.google.com/earth/answer/148099#createoverlay | 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: [https://support.google.com/earth/answer/148134?hl=en | Measuring distances and areas]<br/>[[File:UI GoogleEarthImageEditingUI_Width_inMeters.PNG|thumb400 px|border|alt=Rotation ParameterView|Rotation Parameter in the Editing dialog of Google EarthView]]#* '''ROTATION_CLOCKWISE_DEGREES''': The rotation can be extracted by using the editing tool of Google Earth for image map overlays.{{Clear}}<br/>[[File:UI_GoogleEarthImageEditing.PNG|400 px|border|alt=View|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: [https://support.google.com/earth/answer/148142?hl=en | Creating a new placemark]#** The location can be extracted by using the editing mode of the placemark. <br/>[[File:UI_LocationCenter.PNG|900 px|border|alt=View|View]] {{Attention|Please use the Google Earth Show Lat/Long setting with Decimal Degrees [[https://support.google.com/earth/answer/148070?hl=en| HowTo: Viewing preferences]] . }}
= Studio =
== Create a map overlay document = Add an Image Map Overlay ===The following steps are To add a Map Overlay it is required to create a take the parameters from the georeferenced Map Overlay DocumentImage: <br/>#To ease up the work of the customizer we suggest Navigate to derive a new object from the '''[[SYSCLS FILEDOCUMENT | FILEDOCUMENTMetaClass]]''IMAGEMAPOVERLAY'. The properties are visible in ' via the ''[[Class_Details | Class DetailsBrowser]]''.#Add the Classification <br/> [[SYSCLS_MAPOVERLAY File:IMagemapoverlay.PNG| MapOverlays220 px|border]] to the # Create a new MetaClass by using object in the [[Relation_Editor | Relation {{Bulk Editor]]}}#Define * Choose the required Metaproperties for Filetype (PNG)#* Set a '''Name''' and '''Description'''#* Select the image in the Bulk Editor (FULLPATH)#* Set '''[[SYSCLS_MAPOVERLAY | MapOverlays]]Is Local'''to TRUE#*HowTo:Set the '''Location Center''' by filling out the '''[[HowTo:Create_a_new_MetaProperty SYSCLS GEO|Create a new MetaPropertyGeo Property]]''' <br/>[[File:UI_MetaPropertiesMapOverlayUI_ExampleObjects_BulkEditor.PNG|990 px|border|alt=View|View]]#Add * Set the required '''[[Metaproperty | MetaPropertys]]Rotation Clockwise Degree''' to #* Set the '''[[MetaClass| Meta Class]]Width'''.(in Meters)#*HowToSet the '''Z-Level''' (Default: [[HowTo:Add_a_MetaProperty_to_a_MetaClass | Add a Metaproperty to a Metaclass]]<br/>[[File:UI Properties MapOverlay.PNG|400 px|border|alt=View|View]] 0) #Save the object with {{key press|Ctrl|S}}#Build and Release the Customizing {{key press|F5}}# Check the Classification in the ''[[Object Explorer | Object Explorer]]''
=== Publish the map overlay Map Overlay ===To publish the Image Map Overlay to the {{UBIK.Android Client it is required to configure }} client the [[Application_Context_Management | ACM]].<br/>has to be configured:#Create a '''[[METACLASSSCOPE| METACLASSSCOPE]]''' for the Image Map Overlay Meta Class<br/>MetaClass#* HowTo: [[HowTo:Create_a_new_MetaClassScope | Create a Metaclass Scope]]<br/># Assign the Properties to the Metaclass Scope<br/>#* Required Properties for within the ACM:
#** ''WIDTH_METERS''
#** ''Z_LEVEL''
#** ''LOCATION_CENTER''
#** ''FILETYPE''
# Add Relate the Metaclassscope MetaClassCcope to the '''according [[CONTEXT | CONTEXT]]'''<br/>
# Save the object with {{key press|Ctrl|S}}
# [[HowTo:Release_MetaDefinitions| Release the MetaDefinitions]]
# Check the Classification in the ACM Manager
=== Add Image Map Overlay to Infrastructure ===
To finally display the image overlay on the client it is necessary to put it right into the application's infrastructure.
# Open the according [[CONTEXT]] in the ''[[Relation Editor | Relation Editor]]''
# Add the newly created overlay object per drag and drop, from the [[MetaClass]] ''IMAGEMAPOVERLAY'', to ''"Infrastructre objects"'' ([[SYSREL INFRASTRUCTURE|SYSREL INFRASTRUCTURE]]) <br/> [[File:ImageToACM.PNG|330 px|border]]
# Save the project with {{key press|Ctrl|S}}
The image map overlay has been added to your application.
<headertabs />
== 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
#* Set the '''[[SYSCLS GEO|Geo Property]''' <br/>[[File:UI_ExampleObjects_BulkEditor.PNG|990 px|border|alt=View|View]]
# Save the object with {{key press|Ctrl|S}}
<headertabs />== See also ==* [[SYSCLS_MAPOVERLAY]]
[[Category:Document|Create Image Map Overlays]][[Category:How-To|Create Image Map Overlays]][[Category:Pages with broken file linksPublishing|Create Image Map Overlays]]