What are the GeoBase Data Files?

Overview

GeoBase uses GBFS data files with a .gbfs extension. While most files contain comprehensive information about a geographic area, some contain broader information (such as country names and borders) that is required by GeoBase regardless of which other data files are being used.

GBFS files may be created from custom data using the Alchemy tool. 

It is possible to control what areas are mappable by choosing which GBFS files are available to GeoBase.

Locations of Data Files (GBFS)

GeoBase data files must have .gbfs extensions. GeoBase searches for data files in the following order:

  1. At the location specified by the Settings.DataPath value, if it has been set
  2. In the startup directory of your application
  3. In the directory that contains geobase.net.dll
  4. In a subdirectory named data below the directory referred to by the Path registry key, stored at HKEY_LOCAL_MACHINE\SOFTWARE\Telogis\GeoBase 

Once a folder has been found in this list, GeoBase checks a version dependent subfolder. This subfolder has a name of the form "gb.<major>.<minor>". For example, gb.3.9 will have GBFS files that will be used by GeoBase version 3.9 in it. This allows multiple versions of GeoBase to coexist on a single machine. If no version specific subfolder exists, GBFS files from the main folder are used.

Example

One use case might be that your application sets Settings.DataPath to E:\GeoBase\Data. When GeoBase looks for its data files, it will first check E:\GeoBase\Data\gb.3.8, if no GBFS files are found, it will try opening the data files in E:\GeoBase\Data.

Published, Oct 31st 2013, 00:45