Home
Business Logic / Control
Endless possibilities in data processing for your projects.
Control Graphics
Maps Widget
This section provides the reference documentation for all properties, functions, and events available for the Maps Widget.
"projection"
The type of projection that is used to display the 3D globe onto the 2D screen.

Version Information
Release Notes, Update information, Certifications and Frequently Asked Questions.
Concepts
Your first step into modern and powerful process visualization.
Deployment
Topics you need to know before using WinCC OA.
Security
Go beyond the norm in cybersecurity.
Engineering
Powerful tools for easy or complex engineering tasks.
Data Management
Classify, structure and archive your data.
Business Logic / Control
Endless possibilities in data processing for your projects.
- Introduction to CTRL
  An introduction to the product's own programming language Control(CTRL).
- Control Classes
  The overview of classes available in Control.
- Types of Control Functions
  An overview of the types of functions distinguished within Control.
- Control Graphics
  - Graphics objects
  - Attributes of graphics objects
  - Arc
  - AttentionEffect EWO functions
  - Bar trend
  - BarChart3D EWO
  - Button
  - Calendar
  - Cascade
  - Chart.ewo
  - Checkbox
  - Clock
  - Combobox
  - DateTimeEdit EWO functions
  - DialGauge EWO
  - DoubleSpinbox EWO
  - DpTreeView
  - DpTypeView
  - Embedded module
  - Frame
  - GIS Viewer EWO
    WinCC OA GIS Viewer provides the cartographic representation of objects in WinCC OA. This new feature provides numerous advantages, particularly in geographical distributed systems, like in Water, Traffic, Oil & Gas or Energy.
  - Label Functions
  - Layoutgroup functions
  - LCD number
  - Maps Widget
    This section provides the reference documentation for all properties, functions, and events available for the Maps Widget.
    - "animationsEnabled"
      Specifies how a new visible section of the map is displayed.
    - "distance"
      Distance of the view point from the globe in meters.
    - "latitude"
      Specifies the latitude of the center of the visible map section in degrees.
    - "longitude"
      Specifies the longitude of the center of the visible map section in degrees.
    - "mapThemeId"
      Allows you to select one of the predefined map themes to be shown.
    - "persistentTileCacheLimit"
      Maximum size of the persistent tile cache (tiles stored on disk) in kilobytes.
    - "projection"
      The type of projection that is used to display the 3D globe onto the 2D screen.
    - "renderPlugins"
      Returns a list of plug-in names that are available in the Maps Widget.
    - "showCrosshairs"
      Specifies whether a crosshairs symbol should be displayed for the current position.
    - "showGrid"
      Specifies whether a coordinate grid is shown within the map.
    - "showNavigation"
      Specifies whether the interactive navigation box is displayed in the lower right corner of the Maps Widget.
    - "showOverviewmap"
      Specifies whether an overview map as well as the current position on the map are displayed.
    - "showScalebar"
      Specifies whether a scale bar for the map is displayed.
    - "volatileTileCacheLimit"
      Maximum size of the volatile tile cache (tiles stored in memory) in kilobytes.
    - "workOffline"
      Specifies whether the Maps Widget will try to access online data or only displays data available locally.
    - "zoomStep"
      Specifies the factor which is zoomed per step when using the function zoom().
    - "addEmptyLayer()"
      This function adds a new empty layer to the Maps EWO.
    - "addGeoDataFile()"
      The function adds offline map material into the Maps Widget.
    - "addLine()"
      This function adds a new empty line to the Maps EWO.
    - "addPlacemark()"
      The function adds a new placemark to the map.
    - "addPointToLine()"
      The function adds a point to a line of the Maps EWO.
    - "addPolygon()"
      The function adds an empty polygon to the Maps EWO.
    - "addSymbol()"
      The function allows to add a custom symbol to the Maps Widget.
    - "appendPolygonInnerBoundaries()"
      The function adds a cutout to a polygon of the Maps EWO.
    - "centerOn()"
      Changes the map view to stated coordinates.
    - "centerOnBox()"
      Changes the map view within the stated region borders.
    - "centerOnHome()"
      Changes the map view to the defined home coordinate.
    - "centerOnLine()"
      Changes the map view to the center of the specified line.
    - "centerOnPlacemark()"
      Changes the map view to the stated placemark.
    - "centerOnPolygon()"
      Changes the map view to the center of the specified polygon.
    - "centerOnSymbol()"
      Changes the map view to the stated object.
    - "clearLayer()"
      The function removes all polygons, lines and symbols of a specific layer of the Maps EWO.
    - "getLayerClickEnabled()"
      The function returns whether the click events for a specific layer of the Maps EWO are enabled.
    - "getLayerFromName()"
      The function returns the layer number for a given name of a layer in the Maps EWO.
    - "getLayerName()"
      The function returns the name of a specified layer of the Maps EWO.
    - "getLayers()"
      The function returns all layers of the Maps EWO.
    - "getLineColor()"
      The function gets the color of a line of the Maps EWO.
    - "getLinePoints()"
      Returns the points of a specified line of the Maps EWO.
    - "getLines()"
      The function returns all lines of the Maps EWO.
    - "getLineType()"
      Returns the type of a specified line of the Maps EWO.
    - "getLineWidth()"
      The function returns the width of a line of the Maps EWO.
    - "getMapCoordinates()"
      Returns the current map coordinates for a specified position on the panel..
    - "getPluginData()"
      The function returns the properties of a specific plugin.
    - "getPolygonColor()"
      The function gets the colors of a polygon of the Maps EWO.
    - "getPolygonFillPattern()"
      Returns the fill pattern for a specified polygon of the Maps EWO.
    - "getPolygonInnerBoundaries()"
      Returns the inner boundaries of a specified polygon of the Maps EWO..
    - "getPolygonLineType()"
      Returns the line type of the border of a specified polygon of the Maps EWO.
    - "getPolygonLineWidth()"
      The function returns the line width of the outline of a polygon.
    - "getPolygonOuterBoundaries()"
      Returns the outer boundaries of a specified polygon of the Maps EWO.
    - "getPolygons()"
      The function returns a list of all polygons of the Maps EWO.
    - "getScreenCoordinates()"
      Returns the current screen position of a location on the map.
    - "getVisibleBox()"
      The function gets the current visible maps area.
    - "hideLayer()"
      This function hides a layer of the Maps EWO.
    - "ignoreSslErrors()"
      Instructs the Maps Widget to ignore specific SSL errors when loading map tiles.
    - "isLayerVisible()"
      This function is used to get the visibility of a layer of the Maps EWO.
    - "isPositionVisible()"
      Returns if the specified coordinates are shown in the current visible map area.
    - "latLonToString()"
      The function converts float coordinates into string coordinates.
    - "layerExists()"
      Returns whether the specified layer exists on the Maps EWO.
    - "lineExists()"
      Returns whether the specified line exists on the Maps EWO.
    - "moveLayerToTop()"
      The function moves a layer of the Maps EWO to the top in the hierarchy.
    - "pan()"
      The function moves the map by the given number of steps
    - "polygonExists()"
      Returns whether the specified polygon exists on the Maps EWO.
    - "removeGeoDataFile()"
      The function removes offline map material from the Maps Widget.
    - "removeLayer()"
      This function removes a layer from the Maps EWO.
    - "removeLine()"
      The function deletes a line from the Maps EWO.
    - "removePlacemark()"
      Removes the stated placemark.
    - "removePolygon()"
      The function removes a polygon from the Maps EWO.
    - "removeSymbol()"
      Removes the stated object.
    - "setHome()"
      Sets the home coordinate within the map.
    - "setLayerClickEnabled()"
      Enables or disables the click events for a specific layer of the Maps EWO.
    - "setLayerVisibleRange()"
      The function sets the viewing distance, for which the specified layer will be shown.
    - "setLineColor()"
      The function changes the color of a line of the Maps EWO.
    - "setLineType()"
      Sets the type of a specified line of the Maps EWO.
    - "setLineWidth()"
      The function sets the width of a line of the Maps EWO.
    - "setPluginData()"
      The function sets the properties of a plugin.
    - "setPolygonColor()"
      The function sets the color of a polygon of the Maps EWO.
    - "setPolygonFillPattern()"
      Sets the fill pattern for a specified polygon of the Maps EWO.
    - "setPolygonLineType()"
      Sets the line type of the border of a specified polygon of the Maps EWO.
    - "setPolygonLineWidth()"
      The function sets the line width of the outline of a polygon.
    - "setPolygonOuterBoundaries()"
      The function sets the corner coordinates of a polygon of the Maps EWO.
    - "showLayer()"
      This function shows a previously hidden layer of the Maps EWO.
    - "stringToLatLon()"
      The function converts string coordinates into float coordinates.
    - "zoom()"
      The function is used to zoom in or out of the map.
    - "clicked"
      The event is triggered whenever the left mouse button is released on the Maps Widget.
    - "geoDataFileAdded"
      The event is triggered if a geoDataFile has been loaded using the function addGeoDataFile().
    - "lineClicked"
      The event is triggered whenever a line is clicked on the map.
    - "polygonClicked"
      The event is triggered whenever a polygon is clicked on the map.
    - "visibleBoxChanged"
      The event is triggered as soon as the visible maps area changes.
  - Panel functions
  - PDF Viewer EWO
  - PictureFlow EWO functions
  - Pipe
  - Polyline
  - Primitive text
  - Progress bar
  - Radio box
  - Rectangle
  - Reference Functions
  - Scheduler.ewo
  - Selection list
  - Slider
  - Spin button
  - Splitter
  - Tab
  - Table
    The available functions of the Table object.
  - TextEdit
  - Text field
  - Thumb wheel
  - ToggleSwitch EWO
  - Tree widget
  - Trend
  - VideoPlayer.ewo
  - WebView EWO
    All events and functions, specifically available for the WebView EWO.
  - Zoom Navigator
    Functions available for the Zoom Navigator widget.
- CONTROL Functions
- CtrlExtension
  The CtrlExtension allows the addition of custom C++ code.
- CTRL Debugger
  You can use the CTRL debugger to debug the Control programming language. The debugger can be used via its own panel, which also enables the monitoring and setting of variable values during the execution of a script.
- SQL in CONTROL
  The database functions enable you to quickly carry out value queries on datapoints and elements.
- WinCC OA JavaScript Manager for Node.js
  The WinCC OA JavaScript Manager for Node.js is a manager that allows for the integration of the TypeScript/JavaScript runtime environment Node.js into WinCC OA.
- API Manager
  The WinCC OA API (Application Programming Interface) offers a number of functions adding special Managers to this process control system.
Data Visualization
User interfaces, Trends and Reports for every purpose and device.
Southbound Interfaces
The process connection to the actual machines/sensors.
Northbound Interfaces
Your portal to the cloud or supervising systems.
Web Connectivity / Network Interfaces
Data exchange, APIs and web technologies
User Management
All about authorization, authentication and login-customization.
Availability
How to get your system uptime to the maximum.
Reporting
Create state of the art project reports without limits.
Addons
Useful tools and enhancements for special demands.
Reference Tables
Detailed and extensive content for special project adaptation.
Videos & Tutorials
Explore the capabilities of WinCC OA with our carefully selected collection of video tutorials and guides.
eLearning
Build Your Expertise Step by Step
Documentation
Basic information about terms and functions within the documentation.
Support & Services
An experienced team of support agents, consultants and trainers are ready to facilitate active partnerships with our customers, so they can profit from our comprehensive service.
Disclaimer
A brief clarification of liability exclusions or legal notices.
SIMATIC WinCC OA World
Explore the World of WinCC OA and Stay updated with the latest product news

"projection"

The type of projection that is used to display the 3D globe onto the 2D screen.

Synopsis

shape.projection(string type);

Parameters


Parameter	Description
type	The projection type. Following types are available: Spherical (default) Equirectangular Mercator Gnomonic Stereographic LambertAzimuthal AzimuthalEquidistant VerticalPerspective

Details

The type of projection that is used to display the 3D globe onto the 2D screen. Different projection types provide different views and distortion characteristics.

Assignment

Maps Widget