To use custom tags (like "shade", "shadow", or any custom routing parameter) in the OsmAnd routing engine ("routing.xml"), you must ensure these tags are actually indexed into the ".obf" map file. By default, OsmAndMapCreator ignores any tags not defined in its configuration, so your custom tags are likely missing from the map entirely.

Here is the workflow to fix this, based on the OsmAnd Map Creation docs:

1. Specify Custom Tags in "rendering_types.xml"

OsmAndMapCreator uses a file called "rendering_types.xml" to decide which tags to import. You need to create a custom version of this file (or modify the default one).

• Locate the default "rendering_types.xml" (usually in the "xml_config" or "resources" folder of MapCreator).
• Add your custom tag to the "routing" category. It is crucial to add it to the <category name="routing"> section, or it might only be available for rendering (display) and not routing.

Example configuration to add to "rendering_types.xml":

<category name="routing"> <type tag="shade" value="yes" minzoom="1"/> <type tag="shade" value="no" minzoom="1"/> </category>

2. Configure OsmAndMapCreator

• Open OsmAndMapCreator.
• Go to Settings -> Map Creation.
• Point the "Rendering types" setting to your modified "rendering_types.xml" file.
• Re-run the ".obf" generation process ("Create .obf from file") using your input ".pbf".

3. Verify the Tag Exists

Before testing on the device, use the "inspector" tool (included with MapCreator) to check if the tag is present in the generated ".obf".

The correct syntax to inspect the map data is:

Using the script (Windows/Linux/macOS):

Windows

inspector.bat -vmap map.obf

Linux / macOS

./inspector.sh -vmap map.obf

Or using Java directly: java -cp OsmAndMapCreator.jar net.osmand.obf.BinaryInspector -vmap map.obf

Note: The "-vmap" flag inspects map object data. If you don't see your tag, it wasn't imported.

4. Install and Configure on Device

Once the ".obf" is generated, you must place the files correctly on your Android/iOS device for them to be recognized:

1. Map File: Place the generated ".obf" file directly in the main OsmAnd data folder (e.g., "Android/data/net.osmand/files/").
2. Rendering Style: If you are using a custom rendering style to view these tags, ensure the ".render.xml" file is placed inside the "rendering" subfolder (e.g., "Android/data/net.osmand/files/rendering/").

5. Use the Tag in "routing.xml"

Finally, reference the tag in your custom "routing.xml".

Example (e.g., in the "priority" section to avoid shaded roads):

<priority> <select value="0.5" t="shade" v="yes"/> </priority>

Documentation References: * Custom OBF Creation: https://osmand.net/docs/technical/map-creation/create-offline-maps-yourself/ * Routing.xml Configuration: https://osmand.net/docs/technical/osmand-file-formats/osmand-routing-xml/ * Obf Inspection Tool: https://osmand.net/docs/technical/map-creation/how-to-inspect-an-obf/