Help

Contents

Overview

This document is the info page for https://buildingid.github.io/.

Usage Guides

Apps

Drawing Tools

The Drawing Tools app lets you:

Screenshot of \

The user interface, shown above, is subdivided horizontally into 3 sections:

Using the Navigation Bar

The left-hand side of the navigation bar links to the homepage and to the other apps/examples.

The right-hand side of the navigation bar lets you:

Search by Location

To search by location, type the name of the location into the "Search by Location" text input field (labelled 1). The top 5 suggested locations are automatically displayed in a drop-down list. Select a suggestion by clicking the corresponding list item. When a list item is clicked, the map will automatically pan and zoom to the corresponding location.

Code Length

The OLC grid resolution level is selected using the "Code Length" drop-down menu (labelled 2).

Note: The term "Code Length" is derived from the OLC specification and refers to the number of alphanumeric characters in the OLC string.

Using the Map

The map component is provided by Bing Maps. For in-depth guides, please refer to Bing Maps Help.

Street Maps

Two street map views are available: Road view, and Aerial view.

Road view is the default map view and displays vector imagery of roads, buildings, and geography.

Aerial view overlays satellite imagery onto the map and highlights roads and major landmarks. When in the aerial view, labels are enabled/disabled using the "Labels" slider control.

To change the street map view, use the drop-down menu in the top-right-hand corner of the map (labelled 3).

Locate Me

Pan the map to your current location by clicking the "Locate me" control on the right-hand side of the map (labelled 4).

Controlling Zoom and Pan

Zoom the map by scrolling or by clicking the "+" and "-" zoom controls on the right-hand side of the map (labelled 5).

Pan the map by dragging and dropping.

Bing Maps Drawing Tools

The toolbar (labelled 6) in the top-left-hand corner of the map provides the Bing Maps drawing tools:

To draw an area on the map, click the polygon toolbar icon to enter drawing mode, then click the map once for each vertex of the shape. Finally, when in drawing mode, press the ESC key or click the polygon toolbar icon to save the new shape and exit drawing mode.

To edit an existing shape, click the edit toolbar icon to enter editing mode, then click the shape that you would like to edit. Finally, when in editing mode, press the ESC key or click the edit toolbar icon to save the changes to the existing shape and exit editing mode.

To erase an existing shape, click the erase toolbar icon to enter erase mode, then click the shape that you would like to erase. Finally, when in erase mode, press the ESC key or click the erase toolbar icon to exit erase mode.

Using the Data Input Form

Use the data input form to add UBID code strings and WKT vector geometry objects to the map.

Code

To add a UBID code string to the map, type the UBID code string into the "Code" text input field (labelled 7), then press the ENTER key or click the "+" button to the left of the "Code" text input field.

Note: The UBID code string is automatically validated. If the UBID code string is valid, then the "Code" text input field is highlighted in green color. If the UBID code string is invalid, then the "Code" text input field is highlighted in red color.

Well Known Text

To add a WKT vector geometry object to the map, type the WKT string into the "Well Known Text" text input field (labelled 8), then press the ENTER key or click the "+" button to the left of the "Well Known Text" text input field.

Note: The WKT string is automatically validated. If the WKT string is valid, then the "Well Known Text" text input field is highlighted in green color. If the WKT string is invalid, then the "Well Known Text" text input field is highlighted in red color.

Examples

Decode Example

Coming soon…

Encode Example

Coming soon…

Well Known Text Example

Coming soon…