Landmark Routing
PLEASE NOTE: We just added a new enhancedNarrative route option to Route Services. This new option will essentially perform the same functionality as the current Landmark Routing Service. In the near future, there are plans to add more landmark features to extend/differentiate this service.
The Landmark Routing function provides the user with additional informational callouts/landmarks in the narrative. Currently a route can be returned with possible intersection counting, previous intersection, and/or next intersection/gone too far callouts in the regular narrative. Additional landmark types will be added in future releases. NOTE: In order for Landmark Routing to function correctly, it is necessary for the following parameter (described below) to be used. A returned result will contain the route & route narrative, along with possible intersection counts and additional maneuver notes to add helpful information along the way.
Service Documentation
Service URL: /directions/v1/landmarkrouting
Parameters
| Name | Description |
|---|---|
| narrativeType | Specifies the type of narrative to generate.
Default = 'text' (Standard text narrative).
Note: In order to view the proper landmark note styles, the narrativeType
needs to be set to 'microformat'. Microformat uses HTML span tags with class attributes to
allow parts of the narrative to be easily styled via CSS.
Explanation
|
Response
The response from a Landmark Routing call is identical to a normal Route
call. Please also review the Route Response Maneuver Notes section for further information.
NOTE:Intersection Counting is enabled in Landmark Routing which means instead of seeing this in the narrative:
Take a RIGHT onto N DUKE ST., it's now possible to see this:
Take the 2nd RIGHT onto N DUKE ST., if applicable.
| Response Field | Description | JSON Example Return Value(s) | XML Example Return Value(s) |
|---|---|---|---|
| maneuverNotes | A collection of maneuverNote objects, one for each maneuver. | maneuverNotes: [...] |
<maneuverNotes>...</maneuverNotes> |
| ruleId | A unique id that is assigned to a particular maneuver note. This rule Id is used
to determine the order that the maneuver notes will be displayed in the narrative.
Possible return values are:
|
ruleId: 1 |
<ruleId>1</ruleId> |
| manNote | Returns the maneuver note for a particular maneuver. For Landmark Routing, maneuver notes can exist for Previous Intersections and/or Next Intersections/Gone Too Far's. They can also exist for Timed Turn Restrictions, Timed Access Roads, HOV Roads, Seasonal Closures, and Timed Direction of Travel. |
{manNote: "VA-7 E is 0.1 miles past CARLIN SPRINGS RD"},
{manNote: "F ST NW is just past E ST NW"},
{manNote: "Your destination is just past 6TH ST NW"}
{manNote: "If you reach CARLYN HILL DR you've gone about 0.1 miles too far"},
{manNote: "If you reach E 43RD ST you've gone a little too far"},
{manNote: "If you are on RENNELL DR and reach SPRUCE ST S you've gone a little too far"}
|
<manNote>VA-7 E is 0.1 miles past CARLIN SPRINGS RD</manNote>
<manNote>F ST NW is just past E ST NW</manNote>
<manNote>Your destination is just past 6TH ST NW</manNote>
<manNote>If you reach CARLYN HILL DR you've gone about 0.1 miles too far</manNote>
<manNote>If you reach E 43RD ST you've gone a little too far</manNote>
<manNote>If you are on RENNELL DR and reach SPRUCE ST S you've gone a little too far</manNote>
|
| manNoteType | Used to specify the type of maneuver note.
Possible return values are:
|
manNoteType: "24" |
<manNoteType>"24"</manNoteType> |
Live Sample
See this feature in action on our live Landmark Routing sample page (link will open in a new window.)
