Functions to query map data.
Functions | |
DW_API_PUBLIC dwStatus | dwMaps_getBounds (dwMapsBounds *bounds, dwConstMapHandle_t mapHandle) |
Get bounds of map data currently in memory. More... | |
DW_API_PUBLIC dwStatus | dwMaps_getClosestLaneFromGeoPoint (const dwMapsLane **closestLane, dwMapsGeoPoint *closestPoint, const dwMapsGeoPoint *p, bool onlyDrivable, bool ignoreHeight, float32_t maxRadius, dwConstMapHandle_t mapHandle) |
Get closest lane in the map to a global gps point. More... | |
DW_API_PUBLIC dwStatus | dwMaps_getClosestLaneFromLocalPoint (const dwMapsLane **closestLane, dwVector3f *closestPoint, const dwMapsRoadSegment *referenceRoadSegment, const dwVector3f *position, bool onlyDrivable, float32_t maxRadius, dwConstMapHandle_t mapHandle) |
Get closest lane in the map to a point in a local coordinate of a road segment. More... | |
DW_API_PUBLIC dwStatus | dwMaps_getClosestLaneOnRoadSegment (const dwMapsLane **closestLane, dwVector3f *closestPoint, const dwMapsRoadSegment *referenceRoadSegment, const dwVector3f *position, bool onlyDrivable) |
Get closest lane on a road segment, given a position in coordinates of the same road segment. More... | |
DW_API_PUBLIC dwStatus | dwMaps_getFeature (const dwMapsFeature **mapsFeature, const dwMapsFeatureId *id, dwConstMapHandle_t mapHandle) |
Get a map feature queried by a feature id. More... | |
DW_API_PUBLIC dwStatus | dwMaps_getFeatures (dwMapsFeatureBuffer *features, uint32_t typeFilter, const dwMapsBounds *bounds, dwConstMapHandle_t mapHandle) |
Get features within bounds. More... | |
DW_API_PUBLIC dwStatus | dwMaps_getLane (const dwMapsLane **lane, const dwMapsLaneId *id, dwConstMapHandle_t mapHandle) |
Get a lane queried by a lane id. More... | |
DW_API_PUBLIC dwStatus | dwMaps_getLaneDividerGroup (const dwMapsLaneDividerGroup **laneDividerGroup, const dwMapsLaneDividerGroupId *id, dwConstMapHandle_t mapHandle) |
Get a lane divider group queried by a lane divider group id. More... | |
DW_API_PUBLIC dwStatus | dwMaps_getLaneDividers (dwMapsLaneDividerBuffer *laneDividers, uint32_t typeFilter, const dwMapsBounds *bounds, dwConstMapHandle_t mapHandle) |
Get lane dividers within bounds. More... | |
DW_API_PUBLIC dwStatus | dwMaps_getRoadSegment (const dwMapsRoadSegment **roadSegment, const dwMapsRoadSegmentId *id, dwConstMapHandle_t mapHandle) |
Get a road segment queried by a road segment id. More... | |
DW_API_PUBLIC dwStatus | dwMaps_getRoadSegmentPointers (dwMapsRoadSegmentPointerBuffer *roadSegmentPointers, const dwMapsBounds *bounds, dwConstMapHandle_t mapHandle) |
Get pointers to road segments within bounds. More... | |
DW_API_PUBLIC dwStatus | dwMaps_getRoadSegments (dwMapsRoadSegmentBuffer *roadSegments, const dwMapsBounds *bounds, dwConstMapHandle_t mapHandle) |
Get road segments within bounds. More... | |
DW_API_PUBLIC dwStatus dwMaps_getBounds | ( | dwMapsBounds * | bounds, |
dwConstMapHandle_t | mapHandle | ||
) |
Get bounds of map data currently in memory.
[out] | bounds | Bounds of map data currently in memory. |
[in] | mapHandle | Map handle. |
DW_API_PUBLIC dwStatus dwMaps_getClosestLaneFromGeoPoint | ( | const dwMapsLane ** | closestLane, |
dwMapsGeoPoint * | closestPoint, | ||
const dwMapsGeoPoint * | p, | ||
bool | onlyDrivable, | ||
bool | ignoreHeight, | ||
float32_t | maxRadius, | ||
dwConstMapHandle_t | mapHandle | ||
) |
Get closest lane in the map to a global gps point.
[out] | closestLane | Optional. Closest lane that has been found. |
[out] | closestPoint | Optional. Closest point on the closest lane. |
[in] | p | Query point |
[in] | onlyDrivable | If true, only drivable lanes are considered. |
[in] | ignoreHeight | If true, all points are projected onto height 0 before computing the distances. |
[in] | maxRadius | The maximum radius around the current point to search for map data, in meters |
[in] | mapHandle | Map to read from. |
DW_API_PUBLIC dwStatus dwMaps_getClosestLaneFromLocalPoint | ( | const dwMapsLane ** | closestLane, |
dwVector3f * | closestPoint, | ||
const dwMapsRoadSegment * | referenceRoadSegment, | ||
const dwVector3f * | position, | ||
bool | onlyDrivable, | ||
float32_t | maxRadius, | ||
dwConstMapHandle_t | mapHandle | ||
) |
Get closest lane in the map to a point in a local coordinate of a road segment.
[out] | closestLane | Optional. Closest lane that has been found. |
[out] | closestPoint | Optional. Closest point on the closest lane. |
[in] | referenceRoadSegment | Road segment that defines the coordinate system of the provided position. |
[in] | position | Query point in local coordinates |
[in] | onlyDrivable | If true, only drivable lanes are considered. |
[in] | maxRadius | The maximum radius around the current point to search for map data, in meters |
[in] | mapHandle | Map to read from. |
DW_API_PUBLIC dwStatus dwMaps_getClosestLaneOnRoadSegment | ( | const dwMapsLane ** | closestLane, |
dwVector3f * | closestPoint, | ||
const dwMapsRoadSegment * | referenceRoadSegment, | ||
const dwVector3f * | position, | ||
bool | onlyDrivable | ||
) |
Get closest lane on a road segment, given a position in coordinates of the same road segment.
[out] | closestLane | Optional. Closest lane that has been found. |
[out] | closestPoint | Optional. Closest point on the closest lane. |
[in] | referenceRoadSegment | Road segment that defines the coordinate system of the provided position. |
[in] | position | Query point in local coordinates |
[in] | onlyDrivable | If true, only drivable lanes are considered. |
dwMaps_getClosestLaneFromLocalPoint()
instead. DW_API_PUBLIC dwStatus dwMaps_getFeature | ( | const dwMapsFeature ** | mapsFeature, |
const dwMapsFeatureId * | id, | ||
dwConstMapHandle_t | mapHandle | ||
) |
Get a map feature queried by a feature id.
[out] | mapsFeature | feature whose id matches with 'id'. If not found, nullptr. |
[in] | id | Query feature ID. |
[in] | mapHandle | Map to read from. |
DW_API_PUBLIC dwStatus dwMaps_getFeatures | ( | dwMapsFeatureBuffer * | features, |
uint32_t | typeFilter, | ||
const dwMapsBounds * | bounds, | ||
dwConstMapHandle_t | mapHandle | ||
) |
Get features within bounds.
Feature is returned if at least one geometry point is within the provided bounds
[in,out] | features | User provided feature buffer. |
[in] | typeFilter | Combination of dwMapsFeatureType values to filter the returned features by type. |
[in] | bounds | Query bounds. Defines the region of returned features. All data is returned if bounds is a nullptr. |
[in] | mapHandle | Map to read from. |
DW_API_PUBLIC dwStatus dwMaps_getLane | ( | const dwMapsLane ** | lane, |
const dwMapsLaneId * | id, | ||
dwConstMapHandle_t | mapHandle | ||
) |
Get a lane queried by a lane id.
[out] | lane | Lane whose id matches with 'id'. If not found, nullptr. |
[in] | id | Query lane ID. |
[in] | mapHandle | Map to read from. |
DW_API_PUBLIC dwStatus dwMaps_getLaneDividerGroup | ( | const dwMapsLaneDividerGroup ** | laneDividerGroup, |
const dwMapsLaneDividerGroupId * | id, | ||
dwConstMapHandle_t | mapHandle | ||
) |
Get a lane divider group queried by a lane divider group id.
[out] | laneDividerGroup | Lane divider group whose id matches with 'id'. If not found, nullptr. |
[in] | id | Query lane divider group ID. |
[in] | mapHandle | Map to read from. |
DW_API_PUBLIC dwStatus dwMaps_getLaneDividers | ( | dwMapsLaneDividerBuffer * | laneDividers, |
uint32_t | typeFilter, | ||
const dwMapsBounds * | bounds, | ||
dwConstMapHandle_t | mapHandle | ||
) |
Get lane dividers within bounds.
Some of the returned lane dividers may be outside of the bounds, but it is guaranteed that all lines within the bounds are returned.
[in,out] | laneDividers | User provided lane divider buffer. |
[in] | typeFilter | Combination of dwMapsLaneDividerType values to filter the returned lane dividers by type. |
[in] | bounds | Query bounds. Defines the region of returned lane dividers. All data is returned if bounds is a nullptr. |
[in] | mapHandle | Map to read from. |
DW_API_PUBLIC dwStatus dwMaps_getRoadSegment | ( | const dwMapsRoadSegment ** | roadSegment, |
const dwMapsRoadSegmentId * | id, | ||
dwConstMapHandle_t | mapHandle | ||
) |
Get a road segment queried by a road segment id.
[out] | roadSegment | Road segment whose id matches with 'id'. If not found, nullptr. |
[in] | id | Query road segment ID. |
[in] | mapHandle | Map to read from. |
DW_API_PUBLIC dwStatus dwMaps_getRoadSegmentPointers | ( | dwMapsRoadSegmentPointerBuffer * | roadSegmentPointers, |
const dwMapsBounds * | bounds, | ||
dwConstMapHandle_t | mapHandle | ||
) |
Get pointers to road segments within bounds.
Some of the road segments for the returned pointers may be outside of the bounds, but it is guaranteed that pointers to all road segments within the bounds are returned.
[in,out] | roadSegmentPointers | User provided road segment pointer buffer. |
[in] | bounds | Query bounds. Defines the region of returned lane divider lines. All data is returned if bounds is a nullptr. |
[in] | mapHandle | Map to read from. |
DW_API_PUBLIC dwStatus dwMaps_getRoadSegments | ( | dwMapsRoadSegmentBuffer * | roadSegments, |
const dwMapsBounds * | bounds, | ||
dwConstMapHandle_t | mapHandle | ||
) |
Get road segments within bounds.
Some of the returned road segments may be outside of the bounds, but it is guaranteed that all road segments within the bounds are returned.
[in,out] | roadSegments | User provided road segment buffer. |
[in] | bounds | Query bounds. Defines the region of returned lane divider lines. All data is returned if bounds is a nullptr. |
[in] | mapHandle | Map to read from. |