Get Online Maps: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(31 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[File:GetOnlineMapsDialog.png|thumb|500 px|''Get Online Maps'' dialog.]]
[[File:GetOnlineMapsDialog.png|thumb|600 px|''Get Online Maps'' dialog.]]
Online maps are raster datasets that can contain imagery, elevation, or land use information. Online maps are imported as dynamic imagery—they will update when panning and zooming in or out of the Graphics Window. This requires that the XMS software have an active internet connection.


The '''Get Online Maps''' button allows selecting online data from a variety of different sources. Once online maps has been selected, the data resolution will be automatically adjusted based on the zoom parameters.  Online maps can only be viewed in plan view.
Online maps are accessed through the '''Get Online Maps''' [[File:Add Online Maps Icon.svg|16 px]] macro (in GMS and WMS) or through the ''File'' | '''Add Online Maps''' menu command (in SMS).


Online maps are raster datasets that can contain imagery, elevation, or land use information.  When online maps is available, right-click on each of the map items [[File:GIS Online Image Icon.svg|16 px]] in the Project Explorer to convert them to static images that can be saved to the local hard driveIt is possible to convert or interpolate online maps containing elevation data to various elevation formats.
Once the online maps command is activated, the ''Virtual Earth Map Locator'' dialog will appear, but only if no other dynamic images are in the project. In this dialog, the map location can be specified. See the section [[Import_from_Web#Virtual_Earth_Map_Locator|Virtual Earth Map Locator]] for more information on this dialog.
 
If a projection has not been set, or if the current projection is different than the selected map location, a warning dialog will appear asking for the projection to be set. The [[Projection_Dialogs#Display_Projection_Dialog|''Display Projection'']] dialog will then open. The projection of the map location will be entered as the default if available.
 
With the map location and projection set, the ''Get Online Maps'' dialog will appear. The ''Get Online Maps'' dialog allows selecting online data from a variety of different sourcesOnce online maps has been selected, the data resolution will be automatically adjusted based on the zoom parameters.  Online maps can only be viewed in plan view.


Note that online data sources are on external servers that the XMS software has no control over.  The data may draw/export very slowly or become unavailable at any time.  The XMS software has no control over this.
Note that online data sources are on external servers that the XMS software has no control over.  The data may draw/export very slowly or become unavailable at any time.  The XMS software has no control over this.
 
<!--The '''Advanced''' button allows selecting from other data sources and to use other online data query functions that may not be fully supported.  In the ''Advanced'' dialog, the '''Add Sources From File''' button allows adding new Web Map Service (WMS) sources from an external text file.-->
The '''Advanced''' button allows selecting from other data sources and to use other online data query functions that may not be fully supported.  In the ''Advanced'' dialog, the '''Add Sources From File''' button allows adding new Web Map Service (WMS) sources from an external text file.


More information about the various types of online data can be found by visiting the following links:
More information about the various types of online data can be found by visiting the following links:
 
<!--* [http://nationalmap.gov/elevation.html NED data &ndash; USGS]
* [http://nationalmap.gov/elevation.html NED data &ndash; USGS]
* [https://lta.cr.usgs.gov/SRTM ASTER and SRTM data &ndash; USGS & NASA]
* [https://lta.cr.usgs.gov/SRTM ASTER and SRTM data &ndash; USGS & NASA]
* [http://landcover.usgs.gov/landcoverdata.php NLCD and CORINE (European) Land Cover data]
* [http://landcover.usgs.gov/landcoverdata.php NLCD and CORINE (European) Land Cover data]-->
* [http://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer World Imagery] [http://www.arcgis.com/home/item.html?id=10df2279f9684e4a9f6a7f08febac2a9 More Info]
* [http://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer World Imagery] [http://www.arcgis.com/home/item.html?id=10df2279f9684e4a9f6a7f08febac2a9 More Info]
* [http://services.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer World Street Maps] [http://www.arcgis.com/home/item.html?id=3b93337983e9436f8db950e38a8629af More Info]
* [http://services.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer World Street Maps] [http://www.arcgis.com/home/item.html?id=3b93337983e9436f8db950e38a8629af More Info]
* [http://services.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer World Topo Maps] [http://www.arcgis.com/home/item.html?id=30e5fe3149c34df1ba922e6f5bbf808f More Info]
* [http://services.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer World Topo Maps] [http://www.arcgis.com/home/item.html?id=30e5fe3149c34df1ba922e6f5bbf808f More Info]
* [https://developer.mapquest.com/products MapQuest OpenStreetMap Worldwide Street Maps]
<!--* [https://developer.mapquest.com/products MapQuest OpenStreetMap Worldwide Street Maps]-->
* [http://services.arcgisonline.com/ArcGIS/rest/services/USA_Topo_Maps/MapServer USA Topo Maps] [http://www.arcgis.com/home/item.html?id=99cd5fbd98934028802b4f797c4b1732 More Info]
* [http://services.arcgisonline.com/ArcGIS/rest/services/USA_Topo_Maps/MapServer USA Topo Maps] [http://www.arcgis.com/home/item.html?id=99cd5fbd98934028802b4f797c4b1732 More Info]
* Other data sources-Geologic data, land cover, etc. (use the advanced button)
<!--* Other data sources-Geologic data, land cover, etc. (use the advanced button)-->
 
When online maps is available, right-click on each of the map items [[File:GIS Online Image Icon.svg|16 px]] in the Project Explorer and select '''Export''' to convert them to static images that can be saved to the local hard drive.  It is possible to convert or interpolate online maps containing elevation data to various elevation formats.


==Exporting to a File==
==Exporting to a File==
An online map can be exported to a file and loaded into the project. Do this if wanting to save a local copy and not be dependent on internet access. Also, there may be more commands and options available with a local file, such as interpolation or conversion to other object types, than with online maps.
An online map can be exported to a file and loaded into the project. Do this if wanting to save a local copy and not be dependent on internet access. Two options exist for exporting:
* '''Export''' &ndash; This will export the online map as a raster file in TIF format. In doing this, the data will be resampled. See [[GIS_Conversion_and_Editing#Resampled_Raster|Resample Raster]] for more information.
* '''Export World File''' &ndash; Saves the world file data for the location. This will not include the image itself, only the projection information for a TIF file. A TIF file should be saved using the '''Export''' command.
With a static raster file there may be more commands and options available with a local file, such as interpolation or conversion to other object types, than with online maps.
==Advanced Options==
{{notice|1='''Please Note:''' Using the Advanced option requires very specific and detailed knowledge about the source data. If you need assistance with what to place in each field, you will need to contact the source data provider. Aquaveo is unable to provide any technical support beyond the documentation in this section.}}
Clicking the ''Advanced'' button in the ''Get Online Maps'' dialog will bring up the ''Select Online Source'' dialog. A list of available sources is shown in this dialog. Sources can be added or edited through this dialog.
[[File:SelectOnlineSource.png|thumb|300 px|The ''Select Online Source'' dialog]]
 
Options include:
* '''Duplicate Source''' &ndash; Creates a copy of the selected data source in the list above.
* '''Remove Source''' &ndash; Deletes the selected user-defined data source from the list above. Built-in sources cannot be removed.
* '''Add Sources from File''' &ndash; Brings up a browser where an online data source file (*.csv) can be selected to add a source to the available source list. When new data sources are added in the XMS software, a .csv file on your local computer is modified to include information on the new data source. The .csv files are saved in the user's "Roaming" directory (such as C:\Users\<username>\AppData\Roaming\Aquaveo\SMS 13.X) and can be copied from this directory, edited using a text editor, and passed to other users.
* '''Add New Source''' &ndash; Brings up the ''Add New Source'' dialog.
* '''Edit Source''' &ndash; Brings up the ''Add New Source'' dialog which allows editing an existing source. Built-in sources cannot be edited, but you can view information about the built-in data source and duplicate and edit the duplicated data source if desired.
 
 
The ''Add New Source'' dialog is used when adding a new source and when editing an existing source. Before adding a new database as a source, the project location and projection should be set to a location that inside of the area covered by the source database.
[[File:AddNewSource.png|thumb|300 px|The ''Add New Source'' dialog]]
 
The dialog has the following options:
* ''Service name'' &ndash; Allows entering or changing the name for the source.
* ''Category'' &ndash; Select the data source web service catagory. Can be Web Map Services (WMS), Web Feature Services (WFS), or Terrain Tile Services (TTS). WMS services are normally image data with Red, Green, and Blue bands unless the type of raster is an index map, in which case the WMS will download a single-band image with a lookup table to determine RGB values. WFS services download vector GIS data (point, arc, or polygon shapefiles). The only type of TTS service supported by XMS includes the [https://registry.opendata.aws/terrain-tiles/ Worldwide Elevation Data] web service.
* ''URL'' &ndash; Specifies the URL of the data source.  For a Web Map Service (WMS) data source, this is the location of the WMS service and includes the version number.  For example, it might be in the format https://www.mrlc.gov/geoserver/mrlc_display/ows?service=wms&version=1.1.1 for a WMS service.
* ''Type'' &ndash; Specifies the type source for online data sources in the WMS category of services.  The available options are ArcGIS REST (AGS), OGC Web Map Service (WMS), and Tile Map Service (TMS).
* ''Query layers'' &ndash; This shows a list of available layers from the web service.  The layer can be selected from the list and, when you click the OK button, the layer information is entered into the ''Layers to download'' field.
* ''Layers to download'' &ndash; For sources containing layers (WMS and WFS), which layers to download can be specified here.
* ''Browse to layer legend'' &ndash; This button brings up a web page containing the legend for the specified web service.
* ''Is SSL Safe?'' &ndash; Check this if the data source server is SSL safe.  This tells XMS to skip SSL certificate verification. This option may be needed if the server is using a self signed certificate. Many secure servers will require that this option is turned on.
* ''Minimum cell size'' &ndash; Sets a minimum cell size for data downloaded from the source. Data with cell sizes below this value will not be downloaded.
* ''Maximum cell size'' &ndash; Sets a maximum cell size for data downloaded from the source. Data with cell sizes above this value will not be downloaded.
* ''File abbreviation'' &ndash; Determines the file abbreviation that will be affixed to the file name when the file is downloaded from the web service.
* ''Image format'' &ndash; Determines the file format used to request data from the data source. The TIFF and PNG formats are available.
* ''Tile server upper left X'' &ndash; (only used for images downloaded with a WMS Category and TMS Type) The upper left X-coordinate of the tile server data, in the tile server's coordinate system.
* ''Tile server upper left Y'' &ndash; (only used for images downloaded with a WMS Category and TMS Type) The upper left Y-coordinate of the tile server data, in the tile server's coordinate system.
* ''Tile server lower right X'' &ndash; (only used for images downloaded with a WMS Category and TMS Type) The lower right X-coordinate of the tile server data, in the tile server's coordinate system.
* ''Tile server lower right Y'' &ndash; (only used for images downloaded with a WMS Category and TMS Type) The lower right Y-coordinate of the tile server data, in the tile server's coordinate system.
* ''Tile level at highest resolution'' &ndash; (only used for images downloaded with a WMS Category and TMS Type) The highest resolution tile level available for the specified TMS web service.
* ''Tile server EPSG code'' &ndash; (only used for images downloaded with a WMS Category and TMS Type) The EPSG code used by the TMS web service.
* ''Maximum number of connections'' &ndash; (only used for images downloaded with a WMS Category and TMS Type) Maximum number of simultaneous connections to the TMS web service.
* ''Use Lat/Lon Order in Request'' &ndash; (only used for data downloaded with a WFS Category) Whether to send the WFS request in Latitude (Y)/Longitude (X) order or Longitude (Y)/Latitude (X) order. If this option is turned on, the coordinates are sent to the WFS server in Latitude/Longitude order.
* ''Invert Feature Axis Order'' &ndash; (only used for data downloaded with a WFS Category) When data is downloaded from a WFS service, it is always converted to a shapefile before XMS reads the file.  Sometimes, the X and Y coordinates are inverted in the WFS-downloaded data (the coordinates are listed in Lat/Lon order instead of the traditional Lon/Lat order) and the coordinates need to be inverted in the shapefile before being imported into XMS so the data shows up in the correct location.  Turning this option on tells XMS to invert the axis order when converting the data to a shapefile.
* ''Show Service in Web Import Dialog'' &ndash; This option tells the XMS program to display the service in the web import (Data Service Options) dialog.  The next time the Data Service Options dialog appears, this data source becomes available as an icon in the dialog.
* ''Show Service in Online Map Dialog'' &ndash; This option tells the XMS program to display the service in the Get Online Maps dialog.  The option to make a map an online map is only available for data sources with WMS specified as the category.


==Related Topics==
==Related Topics==
* [[GIS Conversion and Editing]]
* [[GIS Conversion and Editing]]
* [[Data Sources]]




Line 37: Line 87:
[[Category:Raster]]
[[Category:Raster]]
[[Category:GIS]]
[[Category:GIS]]
[[Category:Needs Update]]

Latest revision as of 15:35, 5 December 2023

Get Online Maps dialog.

Online maps are raster datasets that can contain imagery, elevation, or land use information. Online maps are imported as dynamic imagery—they will update when panning and zooming in or out of the Graphics Window. This requires that the XMS software have an active internet connection.

Online maps are accessed through the Get Online Maps Add Online Maps Icon.svg macro (in GMS and WMS) or through the File | Add Online Maps menu command (in SMS).

Once the online maps command is activated, the Virtual Earth Map Locator dialog will appear, but only if no other dynamic images are in the project. In this dialog, the map location can be specified. See the section Virtual Earth Map Locator for more information on this dialog.

If a projection has not been set, or if the current projection is different than the selected map location, a warning dialog will appear asking for the projection to be set. The Display Projection dialog will then open. The projection of the map location will be entered as the default if available.

With the map location and projection set, the Get Online Maps dialog will appear. The Get Online Maps dialog allows selecting online data from a variety of different sources. Once online maps has been selected, the data resolution will be automatically adjusted based on the zoom parameters. Online maps can only be viewed in plan view.

Note that online data sources are on external servers that the XMS software has no control over. The data may draw/export very slowly or become unavailable at any time. The XMS software has no control over this.

More information about the various types of online data can be found by visiting the following links:

When online maps is available, right-click on each of the map items GIS Online Image Icon.svg in the Project Explorer and select Export to convert them to static images that can be saved to the local hard drive. It is possible to convert or interpolate online maps containing elevation data to various elevation formats.

Exporting to a File

An online map can be exported to a file and loaded into the project. Do this if wanting to save a local copy and not be dependent on internet access. Two options exist for exporting:

  • Export – This will export the online map as a raster file in TIF format. In doing this, the data will be resampled. See Resample Raster for more information.
  • Export World File – Saves the world file data for the location. This will not include the image itself, only the projection information for a TIF file. A TIF file should be saved using the Export command.

With a static raster file there may be more commands and options available with a local file, such as interpolation or conversion to other object types, than with online maps.

Advanced Options

Clicking the Advanced button in the Get Online Maps dialog will bring up the Select Online Source dialog. A list of available sources is shown in this dialog. Sources can be added or edited through this dialog.

The Select Online Source dialog

Options include:

  • Duplicate Source – Creates a copy of the selected data source in the list above.
  • Remove Source – Deletes the selected user-defined data source from the list above. Built-in sources cannot be removed.
  • Add Sources from File – Brings up a browser where an online data source file (*.csv) can be selected to add a source to the available source list. When new data sources are added in the XMS software, a .csv file on your local computer is modified to include information on the new data source. The .csv files are saved in the user's "Roaming" directory (such as C:\Users\<username>\AppData\Roaming\Aquaveo\SMS 13.X) and can be copied from this directory, edited using a text editor, and passed to other users.
  • Add New Source – Brings up the Add New Source dialog.
  • Edit Source – Brings up the Add New Source dialog which allows editing an existing source. Built-in sources cannot be edited, but you can view information about the built-in data source and duplicate and edit the duplicated data source if desired.


The Add New Source dialog is used when adding a new source and when editing an existing source. Before adding a new database as a source, the project location and projection should be set to a location that inside of the area covered by the source database.

The Add New Source dialog

The dialog has the following options:

  • Service name – Allows entering or changing the name for the source.
  • Category – Select the data source web service catagory. Can be Web Map Services (WMS), Web Feature Services (WFS), or Terrain Tile Services (TTS). WMS services are normally image data with Red, Green, and Blue bands unless the type of raster is an index map, in which case the WMS will download a single-band image with a lookup table to determine RGB values. WFS services download vector GIS data (point, arc, or polygon shapefiles). The only type of TTS service supported by XMS includes the Worldwide Elevation Data web service.
  • URL – Specifies the URL of the data source. For a Web Map Service (WMS) data source, this is the location of the WMS service and includes the version number. For example, it might be in the format https://www.mrlc.gov/geoserver/mrlc_display/ows?service=wms&version=1.1.1 for a WMS service.
  • Type – Specifies the type source for online data sources in the WMS category of services. The available options are ArcGIS REST (AGS), OGC Web Map Service (WMS), and Tile Map Service (TMS).
  • Query layers – This shows a list of available layers from the web service. The layer can be selected from the list and, when you click the OK button, the layer information is entered into the Layers to download field.
  • Layers to download – For sources containing layers (WMS and WFS), which layers to download can be specified here.
  • Browse to layer legend – This button brings up a web page containing the legend for the specified web service.
  • Is SSL Safe? – Check this if the data source server is SSL safe. This tells XMS to skip SSL certificate verification. This option may be needed if the server is using a self signed certificate. Many secure servers will require that this option is turned on.
  • Minimum cell size – Sets a minimum cell size for data downloaded from the source. Data with cell sizes below this value will not be downloaded.
  • Maximum cell size – Sets a maximum cell size for data downloaded from the source. Data with cell sizes above this value will not be downloaded.
  • File abbreviation – Determines the file abbreviation that will be affixed to the file name when the file is downloaded from the web service.
  • Image format – Determines the file format used to request data from the data source. The TIFF and PNG formats are available.
  • Tile server upper left X – (only used for images downloaded with a WMS Category and TMS Type) The upper left X-coordinate of the tile server data, in the tile server's coordinate system.
  • Tile server upper left Y – (only used for images downloaded with a WMS Category and TMS Type) The upper left Y-coordinate of the tile server data, in the tile server's coordinate system.
  • Tile server lower right X – (only used for images downloaded with a WMS Category and TMS Type) The lower right X-coordinate of the tile server data, in the tile server's coordinate system.
  • Tile server lower right Y – (only used for images downloaded with a WMS Category and TMS Type) The lower right Y-coordinate of the tile server data, in the tile server's coordinate system.
  • Tile level at highest resolution – (only used for images downloaded with a WMS Category and TMS Type) The highest resolution tile level available for the specified TMS web service.
  • Tile server EPSG code – (only used for images downloaded with a WMS Category and TMS Type) The EPSG code used by the TMS web service.
  • Maximum number of connections – (only used for images downloaded with a WMS Category and TMS Type) Maximum number of simultaneous connections to the TMS web service.
  • Use Lat/Lon Order in Request – (only used for data downloaded with a WFS Category) Whether to send the WFS request in Latitude (Y)/Longitude (X) order or Longitude (Y)/Latitude (X) order. If this option is turned on, the coordinates are sent to the WFS server in Latitude/Longitude order.
  • Invert Feature Axis Order – (only used for data downloaded with a WFS Category) When data is downloaded from a WFS service, it is always converted to a shapefile before XMS reads the file. Sometimes, the X and Y coordinates are inverted in the WFS-downloaded data (the coordinates are listed in Lat/Lon order instead of the traditional Lon/Lat order) and the coordinates need to be inverted in the shapefile before being imported into XMS so the data shows up in the correct location. Turning this option on tells XMS to invert the axis order when converting the data to a shapefile.
  • Show Service in Web Import Dialog – This option tells the XMS program to display the service in the web import (Data Service Options) dialog. The next time the Data Service Options dialog appears, this data source becomes available as an icon in the dialog.
  • Show Service in Online Map Dialog – This option tells the XMS program to display the service in the Get Online Maps dialog. The option to make a map an online map is only available for data sources with WMS specified as the category.

Related Topics