Question 1

How to fix 'Can't decode srtm_*.tif' error when initializing OpenRouteService?

Accepted Answer

Change the elevation provider from 'multi' to 'srtm' in your ors-config.json. Under the 'elevation' section, set 'provider' to 'srtm'. This bypasses the multi-source decoder which fails on certain GeoTIFF files.

Question 2

How to fix ORS Docker container crash with 'this.profiles is null' when using YAML config?

Accepted Answer

This error occurs with ORS Docker image v8.0.0 when using a YAML configuration. Upgrade to the latest version (v9.x or higher) using the updated docker-compose file: `wget https://github.com/GIScience/openrouteservice/releases/latest/download/docker-compose.yml`. Recreate the container to resolve the null profiles issue.

Question 3

Why does the link on openrouteservice.org FAQ not jump to the correct section in the backend documentation?

Accepted Answer

There was a mismatch in the anchor ID: the link used 'when-does-the-osm-data-update-in-the-openrouteservice' while the documentation anchor was 'when-does-the-osm-data-update-in-openrouteservice' (missing 'the'). The link has been updated to the correct URL https://giscience.github.io/openrouteservice/frequently-asked-questions.html#when-does-the-osm-data-update-in-openrouteservice. If you encounter similar issues, check that the heading text exactly matches the generated anchor ID.

Question 4

How to make openrouteservice correctly parse tracktype values with grade ranges separated by hyphen (e.g., grade2-grade4)?

Accepted Answer

The current code in VehicleFlagEncoder only splits on ';' for combined tracktype grades, ignoring hyphen-separated ranges like 'grade2-grade4'. Apply the proposed fix by modifying getTrackGradeLevel() to split on '-' and ';', strip 'grade' prefix, parse integers, and return the maximum grade (capped at 6 for unofficial grades). Also handle single-number values (e.g., '5'). Patch the file ors-engine/src/main/java/org/heigit/ors/routing/graphhopper/extensions/flagencoders/VehicleFlagEncoder.java with the following snippet:

protected int getTrackGradeLevel(String grade) {
    if (grade == null) return 0;
    switch (grade) {
        case "grade1": return 1;
        case "grade2": return 2;
        case "grade3": return 3;
        case "grade4": return 4;
        case "grade5": return 5;
        case "grade6": case "grade7": case "grade8": return 6;
        default:
            String[] parts = grade.split("[;-]");
            int maxGrade = 0;
            for (String part : parts) {
                part = part.trim().toLowerCase();
                if (part.startsWith("grade")) part = part.substring(5);
                try {
                    int val = Integer.parseInt(part);
                    maxGrade = Math.max(maxGrade, Math.min(val, 6));
                } catch (NumberFormatException ignored) {}
            }
            return maxGrade;
    }
    return 0;
}

Rebuild the project afterward.

Question 5

How to add Basque translation to OpenRouteService?

Accepted Answer

A community member has opened a pull request (PR #2207) to add the Basque translation. You can track its progress there. If you want to contribute, follow the official translation instructions at https://giscience.github.io/openrouteservice/contributing/contributing-translations.

openrouteservice

Core Features

What It Can't Do

Use Cases

Tags

Getting Started

Similar Projects