Map provider properties

The following tables list the properties you need to enter for each map data provider supported by the MapApp.

If you use a local map server to store maps from your map provider, the URL you enter for each map source should point to the map on the local server, not to the web site for the map provider.

Important: You may need to set up accounts with some map providers to be able to access the data from their servers. These map providers require an API key or a specific account when you configure map source properties.

ArcGIS

Note: To use an ArcGIS map and include x,y (latitude,longitude) and optionally z (elevation) coordinates, use the XYZ map provider. The XYZ provider is described below.

Baidu

Bing

Google

Open Street Maps

WMS

WMS (the Web Map Service) does not refer to a specific map provider. Rather, it is an interface standard that is supported by multiple map providers, including the U. S. Geological Survey, ArcGIS, and many others.

XYZ

XYZ is a function of the ArcGIS map provider to add tabular data that contains geographic locations in the form of x,y coordinates to your map. If the table also contains z-coordinates, such as elevation values, you can add tabular data as 3D content into your globe or scene. To add a table of x,y coordinates, the table must contain two fields: one for the x-coordinate and one for the y-coordinate. The values in the fields may represent any coordinate system and units, such as latitude and longitude or meters. A field for the z-coordinates that enables 3D geometry is optional.

More information on few properties

Map Source API Key

API key is a unique identifier that authenticates requests associated with the map server for usage and building purposes. To avoid saving the sensitive information like API key inside the application folder, an option to select a named credential which was configured in the Credential Manager has been introduced. The API key property in the map source configuration supports a secret from Named Credentials. When typing the API key, the edit box will list named credentials of type “Secret”. You can select one of these named credentials as your API key. You will still have the option to manually specify your API key in the edit box. In runtime, the map application will read the API key information from the secure location if you have opted to use a named credential. The API key is used when making the connection to the map source.

Note: Displaying the named credentials in the API key edit box is only supported when using a standalone InTouch application.

Map Source CredentialName

The CredentialName property is for specifying a credential which represents a windows user login. This is used when a map server requires Windows authentication. The CredentialName property is a dropdown control which will list named credentials of type “Username and password” or “Domain, username and password”. For a managed InTouch application, the credentials listed will be the ones configured in the Galaxy Repository. For a standalone InTouch application, the credentials listed will be the ones configured in Application Manager. At runtime WindowViewer and the map application will retrieve the credential and use it to authenticate to a local map server.

Set local map server authentication:

1. Install a local map server (For example: GeoServer. For more information see Set up a map server).

2. Create a user with the username and the password matching with the user account information in your map server and grant them the necessary roles to access the maps in the local server. Use this account to authenticate accordingly in the InTouch Application Manager.

3. Open the application in WindowMaker to see the configuration necessary.

4. In WindowMaker open the MapApp source configuration page, at the bottom of the Industrial Graphics pane, select the Properties tab to open properties of the selected map provider.

   The corresponding properties are displayed.

5. Specify the SourceURL to point to your local map server and also select the SourceLayer.

6. Update the CredentialName property.

   It will display list of credentials which are available that you have created in the Credential Manager.

7. You can also select none if you do not use a local map server that requires authentication.

8. Open WindowViewer, and see that the MapApp has connected to the local map server and it is authenticated with the configured Named Credential.