• Diff for "geographic_msgs"
Differences between revisions 7 and 9 (spanning 2 versions)
Revision 7 as of 2012-05-05 22:29:42
Size: 2650
Editor: JackOQuin
Comment: add RFC 4122 link
Revision 9 as of 2013-05-10 22:03:48
Size: 2565
Editor: JackOQuin
Comment: update uuid message info
Deletions are marked like this. Additions are marked like this.
Line 10: Line 10:
Map points, features and segments all have universally unique identifier names ([[http://en.wikipedia.org/wiki/Universally_unique_identifier|UUID]]), using <<MsgLink(geographic_msgs/UniqueID)>> messages. Map points, features and segments all have universally unique identifier names ([[http://en.wikipedia.org/wiki/Universally_unique_identifier|UUID]]), using <<MsgLink(uuid_msgs/UniqueID)>> messages.
Line 12: Line 12:
Each UUID is stored as a human-readable string of hexadecimal digits and dashes in "01234567-89ab-cdef-0123-456789abcdef" format. UUID generation is up to the programmer, but the intent is for matching features within a domain such as Open Street Map to yield the same UUID. The recommended method is [[http://www.ietf.org/rfc/rfc4122.txt|RFC 4122]] variant 5, computing the SHA-1 hash of a URL encoded using the map source. Each UUID is stored as an array of unsigned bytes. UUID generation is up to the programmer, but the intent is for matching features within a domain such as Open Street Map to yield the same UUID. The recommended method is [[http://www.ietf.org/rfc/rfc4122.txt|RFC 4122]] variant 5, computing the SHA-1 hash of a URL encoded using the map source.
Line 16: Line 16:
 * `http://openstreetmap.org/node/99999999`
 * `http://openstreetmap.org/way/99999999`
 * `http://openstreetmap.org/relation/99999999`
 * `http://openstreetmap.org/node/999999`
 * `http://openstreetmap.org/way/999999`
 * `http://openstreetmap.org/relation/999999`
Line 20: Line 20:
Here, `99999999` is the decimal representation of the OSM node, way, or Here, `999999` is the decimal representation of the integer OSM node, way, or

  Show EOL distros: 

geographic_info: geodesy | geographic_msgs

Package Summary

ROS messages for Geographic Information Systems.

geographic_info: geodesy | geographic_msgs

Package Summary

ROS messages for Geographic Information Systems.

geographic_info: geodesy | geographic_msgs

Package Summary

ROS messages for Geographic Information Systems.

geographic_info: geodesy | geographic_msgs

Package Summary

ROS messages for Geographic Information Systems.

geographic_info: geodesy | geographic_msgs

Package Summary

ROS messages for Geographic Information Systems.

geographic_info: geodesy | geographic_msgs

Package Summary

ROS messages for Geographic Information Systems.

Geographic information messages.

Newly proposed, mistyped, or obsolete package. Could not find package "geographic_msgs" in rosdoc: /var/www/docs.ros.org/en/api/geographic_msgs/manifest.yaml

Unique Identifiers

Map points, features and segments all have universally unique identifier names (UUID), using uuid_msgs/UniqueID messages.

Each UUID is stored as an array of unsigned bytes. UUID generation is up to the programmer, but the intent is for matching features within a domain such as Open Street Map to yield the same UUID. The recommended method is RFC 4122 variant 5, computing the SHA-1 hash of a URL encoded using the map source.

For example, the Open Street Map URL scheme is:

  • http://openstreetmap.org/node/999999

  • http://openstreetmap.org/way/999999

  • http://openstreetmap.org/relation/999999

Here, 999999 is the decimal representation of the integer OSM node, way, or relation ID without leading zeros.

Other map sources should use similar conventions.

Cartography

The geographic_msgs/GetGeographicMap service takes a map URL and optional geographic_msgs/BoundingBox, returning a geographic_msgs/GeographicMap,

The map contains a geographic_msgs/WayPoint vector and a geographic_msgs/MapFeature vector. Each point or feature is identified by a geographic_msgs/UniqueID, and optional geographic_msgs/KeyValue properties describing their roles.

Features represent any interesting collection of map points: hiking trails, bicycle paths, streets, highways, tunnels, bridges, rivers, buildings, property boundaries, etc. They contain a sequence of component unique identifiers, which may name points or other features. A feature may not directly or indirectly contain itself, so its subordinate points and features must form a tree structure. But, a feature may belong to more than one higher-level feature.

Route Network

Not all way points in a map are drivable by any particular vehicle. Some delimit buildings, rivers, or property boundaries. The geographic_msgs/RouteNetwork message represents drivable paths as a directed graph using a geographic_msgs/WayPoint vector and a geographic_msgs/RouteSegment vector. Each segment represents an edge from one point to another. Unless the path is one-way, another segment will point in the opposite direction.

Wiki: geographic_msgs (last edited 2013-05-10 22:11:06 by JackOQuin)