Geographic Information Services Division Logo

Pima County Department of Transportation

Geographic Information Services Division

Autodesk MapGuide Tips and Help

Be sure you have read Using Autodesk MapGuide and installed the MapGuide Viewer before proceeding.


MapGuide in a Minute

Start by going to Pima County MapGuide Maps. Review the introductory links on that page and then pick "Main MapGuide Map" to see the main map and then get started with MapGuide:

Pick "Main MapGuide Map" to see the main map and then get started with MapGuide:

  1. The best way to zoom in is to pick the zoom tool (magnifying glass with + ), release the mouse button, and then drag a box over the desired map area by holding down the left mouse button.
  2. More layers appear in the legend on the left as you zoom in.
  3. Click the check box next to a layer in the legend to turn the layer on or off.
  4. Move the mouse cursor over a map feature to identify the feature.
  5. If the cursor changes to a pointing hand over a map feature (mostly parcels), double-click for more information on that feature. This opens a new window. Return to the map by closing the new window. (Click on the "X" in the upper right hand corner of the new window.)
  6. Select parcels or streets by clicking or shift-clicking on them and use View Reports on the MapGuide toolbar to get reports on the selected map features.
  7. Hold the mouse over other MapGuide toolbar tools to see what they do.
  8. Use the right mouse button in the map area for more functions, including printing your map view.
  9. To print the map, right-click in the map area and then select "Print Current View" from the popup menu. The browser's Print button and menu options won't print the map.

Getting MapGuide help

  1. To see online MapGuide Viewer help, click the question-mark map tool or move the mouse cursor over the map itself, right-click, choose "Help" then "Help Contents...".

  2. Or, go directly to the same MapGuide online help with the following links. For a printed copy of the latest version, choose the Acrobat PDF Document link and print the document from the Adobe Acrobat viewer. It's about 40 pages.

  3. Review other topics on this Autodesk MapGuide Tips and Help page you are reading now.

  4. If you've researched what you can online and are still stuck or if you have comments, questions or suggestions, please use our MapGuide Feedback Form or contact e-mail address, e-mail address, or e-mail address

MapGuide Viewer Compatibility Issues

Autodesk MapGuide Viewer Compatibility Issues describes computer, operating system, web browser, pop-up blocker, add-on, and network situations that can cause problems using the MapGuide Viewer.

Common Questions

When will the next orthophotos be available?
The PAG Orthophoto 2005 project gathered (flown) in May 2005 is the latest high resolution PAG imagery we have. The PAG Orthophoto 2008 project was flown in April 2008 with imagery to be available fall 2008.

How do I get orthophoto and aerial imagery data files?
See Getting Orthophotos and Aerial Imagery.

Where do I find all the utilities?
The only utility available on our MapGuide maps is the sewer network maintained by Pima County.
  • Sewers are mapped in the "Sanitary Sewer - Pima County Maintained" layer group on the Main MapGuide Map. The sewer system is operated by Pima County Regional Wastewater Reclamation Department for most of Pima County. They provide the map sewer data for our maps.
  • Tucson Water does not provide us with map data for our MapGuide maps. Selected area maps are available from Tucson Water Customer Services at 310 W. Alameda St. in Tucson.
  • All other utilities are operated by companies that do not share their map data with us. These include electric, telephone, gas, and cable.

How often are the data layers updated?
Data update frequency varies considerably as each data layer is maintained separately.
  • Some layers such as "Parcels - Pima" are maintained daily or concurrently with the data changes, such as "Annexations". Even so, parcel information like the parcel owner is based on assessor records which may lag recorded parcel changes by a few months.
  • Other important layers like the "Street Network," "Subdivisions" and "Zoning" are maintained on a regular basis.
  • Other layers may be updated as infrequently as yearly.
  • Some layers originally created for special projects have no update plan.
  • Orthophoto imagery is updated after each new orthophoto project is completed. See Orthophoto Imagery for more.
  • Lastly, there are layers such as the Section Grid that don't require maintenance.

Our GIS Data Library metadata includes the Date of Last Update, as well as the Source Date and a Maintenance Description for each layer. This update information is maintained manually. Certain updates may not be reflected in the metadata. Conversely, the update date may be the date we updated the library and may not necessarily be true date of the underlying layer. When the update date is important to you, you should seek confirmation of the data from official sources.

When is the next MapGuide class?
See our MapGuide Classes page for information on the class and when it's offered.

How do I print the map? Why can't I print?
See Printing the Displayed Map.

How can I see the latitude and longitude?
There are several ways to display and capture the latitude and longitude of one or more points on the map:

  • The simplest way is to see the latitude and longitude of the cursor position in the status bar just under the map legend on the left. Just move the mouse on the map and see the latitude and longitude in the status bar. The latitude and longitude are displayed in decimal degree format. Your MapGuide Viewer Preferences need to be set to display the mouse position to make this work. To set or verify your Preferences settings, right-click in the map, choose Preferences..., then ensure that "Display mouse position" is checked, and that "Latitude, Longitude" units are selected. The displayed values change when you move the mouse, making it impossible to copy and pasted the values using this method.

  • Internet Explorer on Windows users can use the "Get Lat/Lon" tool in the "Map Tools & Map Info." drop-down list box at the top of the map to show a report of all selected point map features. Select one or more point map features or use the Draw Point Symbol tool to add points to select. See Using the Get Lat/Lon Tool for more.

  • Internet Explorer on Windows users can use a button on the "Zoom to Lat/Lon" tool in the "Map Tools & Map Info." drop-down list box at the top of the map. Open the tool, pick the "Pick point..." button and then pick the point you want on the map to load the lat/lon values into the form. This method has the advantage of putting the lat/lon values in the form where they can be copied and pasted into other applications. They are also displayed in both decimal degree and degrees/minutes/seconds formats.

  • You can double-click on a parcel to get the parcel detail page which displays the latitude and longitude of the parcel's geographic center (centroid).

How can I zoom to a latitude/longitude on the map?
There is a "Zoom to Lat/Lon" tool in the "Map Tools & Map Info." drop-down list box at the top of the map. This allows Internet Explorer on Windows users to zoom to latitude/longitude values from inside MapGuide. You can also use the tool to convert between decimal degrees and degrees/minutes/seconds formats you enter.

If you aren't using Internet Explorer on Windows, there is a link at the bottom of our main MapGuide Maps page that lets you Enter latitude and longitude and zoom to a MapGuide map location by opening a new map window.

How can I find a parcel's area?
See Finding Parcel Areas.

How do I print mailing labels?
See MapGuide Tutorials for Creating Reports and Creating Mailing Labels.

How do I get the source map data files to use in other programs?
For vector data layers (everything except imagery) see the Pima County DOT GIS Data Library. To order aerial imagery files, see PAG Image and Data Ordering.

Where can I find MapGuide for other Arizona counties?
Not all counties or cities have online interactive mapping. Pima County was one of the first to provide this service to the public on the Internet, starting in the fall of 1997. Other jurisdictions may use MapGuide software or they may use different mapping technology. Unfortunately, there is no standardization of the technology or mapping presentation.

See Arizona Counties for links to other county maps we know of. You may also find these state-wide Arizona maps helpful:

Scale and Zooming

The data is on map layers and becomes visible or selectable depending on map scale (zoom factor). The bigger the map, the more detail you see. Some layers are only available at certain scales. For instance, you need to zoom in to see parcels and zoom out to see major streets and routes. The legend to the left of the map adjusts automatically to show the layers available at the current scale. A check mark next to the layer name indicates that the layer is being displayed. You can check boxes to add layers and un-check them to remove layers.

Search Criteria for Addresseses and other Map Features

For tips, see Developing Search Criteria for Addresses and other Map Features in MapGuide

Zoom Goto Tool Tips

For tips, see Zoom Goto Tool Tips

What do the MapGuide Toolbar Buttons and right-click options do?

See MapGuide Toolbar Buttons for a list of button graphics and their use and the Popup Menu Command Summary for the right-click menu options.

"Sticky" Toolbar Buttons

The Select, Pan, Zoom and Zoom Out MapGuide map toolbar tools "stick". That is, the tools stay active until you pick another map tool or press the Esc key. You can pick the Zoom tool and keep clicking on the map to zoom, zoom, zoom.

Remember that you can press the keyboard Esc key to get back to the default tool and map cursor. Or, you can simply pick the "Select" tool on the MapGuide tool bar to get back to the default tool.

"Map Tools & Map Info." Drop-down List Tools

The "Map Tools & Map Info." drop-down list in the title frame at the top of the map provides Internet Explorer users with several custom tools for drawing on the map, linking to oblique aerial photos, getting areas, getting latitude/longitude values, and zooming to latitude/longitude coordinates. Click on the table column headings below for detailed instructions.

Legend Layer Order

With a few exceptions, layers are sorted alphabetically on the Main MapGuide Map within the following groups:

While there are layer six groups above, it's usually sufficient to think of three: points, lines and polygons with orthophotos on the bottom.

A few inconsistencies remain, primarily to keep related layers together in the legend. For instance, sanitary sewer pipes (lines) are included with the three other sanitary sewer point-type features. Also, layers that are just text labels or identifiers are generally just above the corresponding layer. Some layers that should be logically grouped together are separated because the layers are different feature types. For instance "Infrastructure - Pima County DOT - Points" and "Infrastructure - Pima County DOT - Linear" are separated in different groups.

Since the legend order determines which layers appear "on top" of other layers in the map, we need to retain the point/line/polygon grouping so one layer doesn't unnecessarily cover another layer. For instance, we don't want Jurisdictions to cover the Street Network. It isn't possible with current software to eliminate the feature type grouping and have all the layers sorted alphabetically.

Finding Legend Layers and Zoom Goto Categories Quickly

Layers can be hard to find in the legend. There are lot's of them! You may be able to find layers more quickly by typing the first few letters of the layer name. Then the legend cursor moves to the layer starting with what you type. This is a great way to find layers in the legend. You need to do three things to make this work:

  1. As you zoom in more layers become available in the legend. Therefore zoom way in so you can be sure the layer should be in the legend. (You can find the scales layers are available at by looking up the layer using MapGuide Map Data Layer Information but it's easier to just zoom in close.)
  2. The legend needs "focus". That is you must have clicked somewhere in the legend. (When you click in the map and the map has focus, you see a thin gray line at the edge of the map. When the legend has focus, that gray line on the map is gone.)
  3. You need to type those letters quickly. If you can't type that fast, type the first letter several times, pausing after each entry until you see the layer you want. You might try just the first letter of a layer name to see how it works.

The same approach also works with Zoom Goto Category selection on the map's right-click menu. Instead scrolling the category list and picking what you want to zoom to, simply type the first letter or letters of the category and it jumps right to it.

The trick to Zoom Goto is remembering to set the appropriate "Zoom to width" (whether it's in feet of miles) before you zoom. In the case of finding parcels, it's a good idea to set the zoom width very small or close, perhaps .1 miles or 500 feet. This way, your zoom lands right on top of the parcel so you can't miss which one it is. Then use the Zoom Out tool once or twice to zoom the map out to an appropriate view that shows the surrounding area you want to see. If you think you might lose track of the particular parcel when zooming out, select the parcel before zooming out by single-clicking the parcel with your mouse to turn it black. Then you will be able to see the parcel clearly as you zoom out.

Using Overlapping Data

Virtually all useful maps, whether paper or electronic, display overlapping map data. For example, streets typically overlay city limits areas. Also, identifying annotation may overlap some map features. We call each type of map data in the map legend a layer. Map layers overlap like transparencies (or sheets of pasta in lasagna!). Well-designed paper maps order overlapping layers so maps both look good and work well for their intended purposes.

With MapGuide and many other electronic maps, users interact with the maps and adjust map information by panning, zooming, and:

By turning layers on and off, MapGuide users add and remove overlapping map data.

Understanding overlapping map data is essential to getting the most out of MapGuide as well as helping ensure you see what you need on the map. Using MapGuide, there are two ways that overlapping data may be in your map view.

  1. Overlapping layers - Most MapGuide users soon learn that displayed legend layers are on top of each other based on their order in the legend. One or more layers over a layer that is lower in the legend can interfere with viewing the lower layer which is "underneath" displayed layers higher in the legend. Since layer overlapping is fundamental to most MapGuide map viewing, it's important to understand the implications.

  2. Overlapping data in a layer - In relatively rare but important cases, there can be overlapping data in one displayed legend map layer. Special techniques are needed to learn how to understand and identify map features for layers that contain overlapping data. The techniques are important as there may be more mapped in the layer than what you "see" on the map.

Double-clicking on Map Features to get More Information

When you move the mouse pointer over an object that is linked to a another web page, the pointer changes from an arrow to a pointing hand. This means you can double-click on the map feature to load and display a page with more information about the object. Only selected data layers are linked to more data. Popular layers with double-clicked linked data include Parcels, Subdivisions, Annexations, Census, Section Grid, and Zoning. Many other data layers may have this feature. Look for the pointing hand when you move the mouse over a map feature to know when you can double-click for more information.

If you zoom in far enough to see the "Parcels - Pima" layer, it is actually "on top" of other polygonal layers. In this case you need to turn off the "Parcels - Pima" layer to double-click on a the layer of interest "below" the "Parcels - Pima" layer or to see its map tips.

Printing the Displayed Map

The usual methods of using the browser's Print button or "File", "Print..." menu options usually doesn't work. Don't even bother trying.

To print your MapGuide map, move your cursor into the map display window, right-click somewhere within the map area and then select "Print Current View" from the popup menu. The "Print Current View" option in the right-click menu prints the map using the standard Windows printer dialog.

There is no "Print Preview" option and there is no way to preview your printed map before printing.

Autodesk MapGuide Print Samples shows examples of what the major print options look like when printed.

Prior to printing, you can right-click and select "Page Setup..." (just below "Print Current View") to customize some of the printed map's printed appearance by adding or removing a title, legend, scale bar, north arrow, URL address and date/time. The default "Scale plot to fit page" is usually the best choice.

Most users want the map to fill the printed page. Therefore, on most of our maps, we have changed the defaults so the title, legend, scale bar, north arrow, URL address and date/time are not printed on the map. You can customize your map by turning on one or more of those extra features. These options are under Page Setup... in the map's right-click menu. It's usually best to select the Landscape option in your printer's "Print Setup..." dialog to make the map fit the printed page better. By leaving all the optional print features off and using your printer's Landscape mode, the map fills the printed page.

If map details don't print well, try using the techniques for Optimizing Orthophotos, Imagery and Map Details.

If you don't have a color printer, areas filled with color appear as a shade of gray on your printed copy.

If you have problems printing from MapGuide:

Printing to Scale

MapGuide uses a simple ratio for the viewing and printing scale, such as 1:2400. This means that one unit on the displayed map equals to 2400 units on the ground. For instance:

The simple ratio that MapGuide uses means the units are the same for both sides of the ratio.

You may prefer to think of scale as 1 inch to some number of feet rather than a simple ratio. That is, inches to feet rather than inches to inches, or feet to feet. If so, you need to convert your scale to a simple ratio. For example, for a scale of 1 inch equals 200 feet, the scale must be converted to have the same units on both sides to make a simple ratio. In this case it's easiest to convert feet to inches by multiplying 200 feet by 12 inches per foot, giving an equivalent simple ratio of 1:2400 (1 inch to 2400 inches).

To print to a specific scale:

You may see the message "The entire map cannot fit on a single page at the specified print scale. The map will be cropped to fit on the printed page. Do you want to continue printing?" If it won't fit, there is nothing the print process can do to make it fit at your specified scale without cropping.

Viewing Orthophoto Imagery

Optimizing Orthophotos, Imagery and Map Details

You may have trouble getting imagery, such as orthophotos, or map details to appear sharp on printed output, particularly when making large format prints. MapGuide optimizes the delivery of imagery for screen display, not printing.

MapGuide looks at the current displayed map scale as well as the pixel size of your screen window and re-samples the original image data so it is optimized for your display. This is how MapGuide enables fast display of imagery from source files that are many gigabytes in size. While not usually a problem, you may have similar problems making large prints of vector data (points, lines) if your screen size is small. There are a few things you can do to get the best possible resolution and detail when printing MapGuide maps:

Here's a sample image captured from the screen of a tall and narrow parcel area. We used all of the above techniques to get the largest possible image with the most detail. The captured image size is 1186 x 1486 pixels or over 1.7 megapixels. It was captured using a 20 inch, 1600 x 1200 LCD where the displayed image was rotated 90 degrees to be in a "portrait" mode more suitable to the tall and narrow parcel. (If you don't have to scroll the image to see it all, your web browser may be set to resize images to fit the current window.)

Remember that screen or printed detail is always limited by the resolution of the underlying imagery and will not appear sharp if you zoom in too close.

Capturing Your MapGuide View

You cannot download map data and imagery to files directly using MapGuide. It is primarily an interactive viewer, not a data delivery or data download system. That is, if you need the underlying vector or imagery data to use with other software such a ArcGIS, ArcView or AutoCAD, then the best thing you can do it to get the vector data from the Pima County DOT GIS Data Library or aerial imagery from Pima Association of Governments. However, depending on your needs, you may be able to capture adequate data from the screen.

There are two ways you can capture the viewed data using the Internet:

With either of these data and image capture methods, you lose both the spatial reference of the data as well as the exact scale. You may not be able to capture the entire scope of the image you need with sufficient resolution. If you attempt to zoom in on or "blow up" your copy, you will not see the added detail that you would see by zooming in on the map in MapGuide. Zoom to the desired scale before printing or copying to the clipboard.

To ensure that you are getting the best possible image to view, copy or print, see Optimizing Orthophotos, Imagery and Map Details above.

Capturing Vector Data from the Screen

You can capture vector and image data from the displayed map in PostScript format using a little trick. This works with any software that can import PostScript format, certainly including most software from Adobe, among others.

There does not appear to be an easy or direct way to import PostScript into AutoCAD, at least without converting the vector data to a bitmap image. (One possibility for AutoCAD is to convert the PostScript to PDF using Adobe Acrobat Professional and then use techniques described in Importing PDF into CAD Drawings. Scroll down to "PDF Conversion Method".)

To capture vector and image data from a displayed MapGuide map in PostScript:

  1. Install a PostScript driver for any PostScript printer, whether or not you have the printer installed.
  2. Start to print the map to your PostScript printer like any other print.
  3. Choose "Print to file" in the print dialog to save the "printed" results to a file.
  4. If necessary, rename the print file to use .eps or .ps as the filename extension.
  5. Import the PostScript file into your application.

By using this technique, you get the vector data, but all georeferencing information (position on the ground) is lost. You may be able to place and scale the captured data with sufficient accuracy for your needs by using an orthophoto or other base layer of known position and visually finding references common to both the base layer and the captured data you are placing.

Saving and Copying MapGuide Bookmarks

The MapGuide Viewer's bookmarks are stored in your computer's registry. Windows Internet Explorer users can copy the MapGuide Viewer's bookmarks to another PC by exporting them from the old computer's registry to a file and then importing that file's settings into the registry on the new computer.

Caution should be used when exporting and importing registry keys. Incorrect registry changes can damage your computer's settings and even make your computer inoperable. You need Administrator rights on the PCs with permissions to read and modify the registry. You should contact your computer's administrator if you aren't familiar with updating the registry.

The registry key that needs to be exported is:

HKEY_CURRENT_USER\Software\Autodesk\MapGuide Viewer ActiveX Control\CurrentVersion\Bookmarks

To copy the bookmarks registry key, start the regedt32 program, export the key to a file such as MGBookmarks.reg (select the key then File, Export...), copy that file to the new PC, and then import the key into the new PC by double-clicking on the .reg file or choosing File, Import... in regedt32.

MapGuide Tutorials