Spatial Database Support

of 11 Spatial Database Support Global Mapper can import vector data from and export vector data to the following spatial databases: Esri ArcSDE Geodatabase Esri File Geodatabase Esri Personal Geodatabases GeoMedia Access Warehouse (import only) MySQL Spatial Oracle Spatial PostGIS/PostgreSQL Spatialite/SQLite Global Mapper can import raster data from and export raster data to the following spatial databases: Esri ArcSDE Geodatabase Esri File Geodatabase Esri Personal Geodatabases NOTE: In order to import data from an Esri ArcSDE geodatabase or export data to any Esri geodatabase, you must have installed and licensed a copy of Esri ArcGIS 9.3.1 or higher. Support for Esri Geodatabases is only available in the 32-bit version of Global Mapper. You can install the 32-bit and 64-bit versions of Global Mapper side-by-side, and they can share a license. NOTE: In order to import data from a GeoMedia Access Warehouse, you must have installed appropriate Microsoft Access ODBC drivers. If you are using 32-bit Global Mapper, you must have 32-bit Microsoft Access ODBC drivers. If you are using 64-bit Global Mapper, you must have 64-bit Microsoft Access ODBC drivers. Microsoft Access ODBC drivers are linked to the version of Microsoft Access installed on your computer. If you have a 32-bit version of Microsoft Access, you will not be able to install the 64-bit Microsoft Access ODBC drivers, and, therefore, you will have to use the 32-bit version of Global Mapper to import a GeoMedia Access Warehouse. Connecting to an Oracle Spatial Database Global Mapper requires an Oracle file called oci.dll in order to run, so we include a copy of that file as part of the installation. When you connect to an Oracle database, however, you need to use the version of oci.dll that is part of the Oracle client software instead of the one that was installed with Global Mapper. Here is what you need to do to make that happen: 1. Make sure that you have the Oracle client software installed. 2. Make sure that the directory that contains oci.dll is in the system path. This is standard for most Oracle client installations. 3. Make sure that the Oracle client matches Global Mapper in that if you are using 32-bit Global Mapper, you need to use the 32-bit Oracle client, and if you are using 64-bit Global Mapper, you need to use the 64-bit Oracle client. 4. In the Global Mapper installation directory (typically "C:\Program Files\GlobalMapper14" or "C:\Program Files (x86)\globalmapper14"), rename the file "oci.dll" to "oci_original.dll". Loading Data from a Spatial Database There are two ways to load data from a spatial database:

of 11 1. Specify the connection parameters for the spatial database connection. This applies to all of the enterprise databases: ArcSDE, MySQL, Oracle, PostGIS and Microsoft SQL Server 2008 or higher. 2. Use the Connection Manager to define spatial database connections. You can access this functionality by choosing Open Spatial Database... from the File menu. 3. Specify the file that contains a Spatialite database (*.sqlite), a GeoMedia Access Warehouse (*.mdb), an Esri file (.gdb), personal geodatabase (*.mdb), or an Esri ArcSDE geodatabase connection definition (*.sde). (Use Esri ArcCatalog or ArcMap to create an ArcSDE geodatabase connection file.) Choose Open Data File(s) from the File menu to perform this task. The Open Spatial Database dialog allows the user to select the connection parameters that will be used to open an enterprise spatial database. The Name drop-down list contains all of the spatial database connections that are currently defined. Click the New... button to define a new spatial database connection. When the button is clicked, the Database Connection Dialog will be displayed. Once the new connection is set up, the name of that connection will be added to the list and become the selected connection. The User field specifies the user ID required to connect to the database. If the selected database connection has a predefined user ID, then that value will be displayed in this field. This value can be overridden, by typing in a different user ID. The stored database connection definition will not be changed. For Microsoft SQL Server users, Windows Authentication allows a user to connect to the spatial database using his or her current Windows login credential. (To use Windows Authentication, Check the radio button, 'Use Windows Authentication'.) Use the Password field to specify the password required to connect to the database. If the selected database connection has a predefined password, then that value will be automatically entered into this field. This value can be overridden, if needed, by changing types in a different password. The stored database connection definition will not be changed. After you have selected a connection and entered a user ID and password, click the Open button to bring up the Spatial Database Import Options dialog to choose a table from the database. The Cancel button quits the process of opening a spatial database. NOTE: In order to import data from or export data to Microsoft SQL Server 2008 or higher, you must have a Microsoft SQL Server ODBC driver installed.

of 11 For more information on using Global Mapper with Spatial Databases, please see the Spatial Database Support section of the Help Documents. Spatial Database Import Options The Spatial Database Import Options dialog is used to choose the table or tables to be loaded from a spatial database. Global Mapper displays this dialog after you have chosen a spatial database connection, a Spatialite database, an Esri file geodatabase, an Esri personal geodatabase, or an Esri ArcSDE geodatabase connection file. The table list contains the names of the tables in the spatial database. Put a check next to one or more table(s) to indicate which tables you want to load. Click the Check All button to place select all of the tables in the list. Click the Clear All button to remove the check mark from all of the tables in the list. Once you have marked the tables to be loaded, click the OK button to load the tables. The Cancel button quits the process of opening a spatial database.

of 11 If the spatial database being opened contains elevation data or raster imagery, the Spatial Database Import Options dialog will contain a tab to specify raster options. Under Elevation Options, choose the Vertical Unit for the elevation data. The default is meters. If you don't choose the correct unit here, you can always fix it in the Control Center.

of 11 If the spatial database being opened contains vector data, the Spatial Database Import Options dialog will contain the Import Bounds tab. This tab allows the user to select a subset of the input data based on a bounding box. All geometries that intersect the bounding box will be imported into Global Mapper. This functionality applies only to vector data in a spatial database. You can specify the bounding box in the following ways: Choose Load All Data to load all of the data in the selected database tables into Global Mapper. Choose Use Current Screen Bounds to use the current Global Mapper screen bounds as the to define the input bounds. If there is no data loaded into the viewer, then this option will not be available. If there is data loaded in Global Mapper, but the full extent of the data is on the screen, then this option will no be available. Click the Draw a Box... button to draw the bounding box on the screen using your mouse. If there is no data loaded into the viewer, then this option will not be available. Choose Lat/Lon (Degrees) to specify the northwest and southeast corners of the bounding box in degrees of latitude and longitude. Choose Global Projection to specify the northwest and southeast corners of the bounding box in the unit of the current global projection. If there is no data loaded into the viewer, or the viewer currently has no projection defined, then this option will not be available. Choose Corner w/size - Global Projection to specify the northwest corner, and the width and height of the bounding box in the unit of the current global projection. If there is no data loaded into the viewer, or the viewer currently has no projection defined, then this option will not be available. Click the Reset to Last Import Bounds button to retrieve the most recently defined

of 11 bounding box in the unit of the current global projection. If there is no data loaded into the viewer, or the viewer currently has no projection defined, then this option will not be available. Projections and Datums The Global Mapper display space adopts the coordinate system of the first table opened (assuming that there is currently no data loaded.) Subsequent data sets will be transformed to the coordinate system of the first data set loaded or the display projection subsequently selected from the configuration dialog. Exporting Data to a Spatial Database In order to export data to a spatial database, you need to specify the location of the spatial database and one or more table names in which the data will be stored. When writing to an Esri file geodatabase or personal geodatabase, you can create a new database file before writing the tables. If you are exporting data to any of the enterprise database types, you can only create tables in an existing database. To export data to a spatial database, you start by choosing one of the following export options from the File/Export menu: Export Elevation Spatial Database... Export Raster Spatial Database... Export Vector Spatial Database... When the Select Export Format Dialog is displayed, there will be three choices: Esri File Geodatabase Table Esri Personal Geodatabase Table Spatialite DB Table Spatial Database Table Choose the option indicating your desired spatial database type, and press OK to continue. If you choose Spatial Database from the list, Global Mapper will display the Open Spatial Database Dialog. Select the database connection that you want to use, and click OK to continue by specifying Spatial Database Export Options. If you choose Spatialite DB Table, Esri File Geodatabase Table or Esri Personal Geodatabase Table, Global Mapper will display the Select Esri Geodatabase Dialog. The following sections describe that dialog and the required steps to export a table. Selecting Database for Export Use the Select Database Dialog to choose a Spatialite database, Esri file geodatabase or personal geodatabase where you want your exported data to be stored. You can also create a new database, if necessary. You can enter the full path to a Spatialite, file geodatabase or personal geodatabase in the

of 11 Database field, or click the Browse... button to select an existing database from the file system. If you are selecting a Spatialite database or a personal geodatabase, then Global Mapper will display the standard Open File dialog. Spatialite database files have an extension of.sqlite, and personal geodatabase files have an extension of.mdb. If you are selecting a file geodatabase, Global Mapper will display a Folder Selection dialog. Folder names that end in.gdb contain file geodatabases. If you want to create a new database, click the Create New Database... button. Global Mapper will display the Create Database Dialog. Once you have created a new database, the full path will be in the Database field. Once you have selected a database, click the OK button to continue by specifying Spatial Database Export Options. The Cancel button quits the process of exporting data to a spatial database. Creating a Database for Export Use the Create Database Dialog to specify the location and name for a new Spatialite database, Esri file geodatabase or personal geodatabase. Type the full path of the folder where the new database will be located in the Location field, or use the Browse... button to choose a folder from the file system. Type the database name in the Name field. You do not need to add a file extension -- one will be created automatically based on the kind of database being created. Once you have entered both the location and database name, click the OK button to create the database. The Cancel button quits the process of exporting data to a spatial database. Spatial Database Export Options Use the Spatial Database Export Options Dialog to specify the table name(s) and data extents to be used for this data export. A spatial database table is restricted to a single geometry type. This dialog allows you to specify table names for polygon, line, and point geometries based on the data types that are currently in the display.

of 11 On the Table Selection tab for vector data export, you can specify a table name for each of the data types that are currently in the viewer. Note that if you choose an existing table, the data in that table will be replaced with the data in the viewer. 1. To export polygon features, check the Export Areas box, and enter a table name in associated entry field. If you want to export data to an existing table, choose the name from the drop-down list. 2. To export line features, check the Export Lines box, and enter a table name in associated entry field. If you want to export data to an existing table, choose the name from the drop-down list. 3. To export point features, check the Export Points box, and enter a table name in associated entry field. If you want to export data to an existing table, choose the name from the drop-down list. Place a check next to Split Data by Feature Layer Name to export data into a separate table for each non-hidden layer currently loaded. If you choose this option, you can leave the table name blank, and Global Mapper will create a table name from each exported layer name (with invalid characters removed.) If you specify a table name, that name will become a prefix, and the layer name will be added to it. In the case where a layer contains more than one geometry type, a separate table will be created for each geometry type, and the name will have a suffix indicating its geometry type. Check the Export 3D Features option to export data with elevation values. Elevation data will be taken from the layer being exported, and placed in the output feature vertices. If the exported layer does not contain elevation data, the output feature vertices will have their elevation set to 0. Exporting 3D features is currently supported only for Esri file and personal geodatabases.

of 11 Place a check next to Warn Before Replacing Existing Tables to be notified when you choose a table that already exists. You can choose whether to replace the existing table or specify a new table name. On the Table Selection tab for elevation or raster imagery export, you can specify a table name where the data will be stored. Note that if you choose an existing table, the data in that table will be replaced with the data in the viewer. Enter a table name in the Export to Table field. If you want to export data to an existing table, choose the name from the drop-down list. Place a check next to Warn Before Replacing Existing Tables to be notified when you choose a table that already exists. You can choose whether to replace the existing table or specify a new table name. You can use the Export Bounds Panel define the extent of the data that you want to export. Once you have chosen table names and data extents, click the OK button to export the data to the geodatabase tables.

of 11 The Cancel button quits the process of exporting data to a spatial database. Spatial Database Connection Manager The Spatial Database Connection Manager allows you to create and save enterprise spatial database connection definitions. Once a connection has been defined, you can use it when importing and exporting spatial database tables. These connection definitions can be used with the following spatial database: Esri ArcSDE Geodatabase MySQL Oracle Spatial PostGIS The Connections area contains a list of existing connections. To create a new connection, click the New... button. Global Mapper will display the Define Spatial Database Connection Dialog, which can be used to specify the connection parameters for the new connection. To update an existing connection definition, select it in the Connections list and click the Edit... button. Global Mapper will display the Define Spatial Database Connection Dialog, which can be used to update the connection parameters for the selected connection. To delete an existing connection, select it in the Connections list, and click the Delete button. Click the Open Connection... button to open the currently selected connection and load data into Global Mapper. When you have made all of your changes to the spatial database connections, click the OK button to store the new definitions. The Cancel button quits the process of changing spatial database connection definitions. Define Spatial Database Connection Use the Spatial Database Connection Dialog to create or modify the parameters that define an enterprise database connection.

of 11 Choose the option from the Spatial Database Type drop-down list that corresponds to the spatial database you are using. Type a unique Connection Name to identify this connection. The name you use here will be listed in the connection list on the Open Spatial Database Dialog. The Database Information section specifies the location of your database on the network. Fields that are not needed for a particular database vendor will be greyed out and disabled. In the Server field, type the name of the network server where the database is located. Specify the required server port in the Port field. In an Esri ArcSDE geodatabase connection, this is also known as the Service parameter. Enter the database name in the Database Name field. Note that the database name is optional when defining an Esri ArcSDE geodatabase connection. Whether or not it is needed is specific to your particular installation. Use the Authentication section to specify the user and password required to log on to the spatial database. Type a valid User Name. Type a valid Password Put a check next to Save User Name and Password with Database Information if you want to save the authentication information along with the connection definition. The password will be encrypted. Click the Test Connection button to determine whether or no the connection parameters can be used to connect to the spatial database. Once you have entered all of the required information, click the OK button to save the connection definition. The Cancel button quits the process of creating or updating a connection definition.