How to Install GraphHopper on macOS

Introduction

GraphHopper is an open-source routing engine that provides reliable and fast routing functionality. It is widely used in various industries such as logistics, mobility, and tourism. In this tutorial, we will guide you through the steps required to install GraphHopper on macOS.

Prerequisites

• A macOS system
• Java SE Development Kit 11 or greater

Steps

1. Install Java

Before installing GraphHopper, you need to install Java SE Development Kit 11 or greater on your macOS system.

• Visit the official Oracle website to download the latest version of Java SE Development Kit.
• Follow the on-screen instructions to install Java on your machine.

2. Download GraphHopper

• Visit the official GraphHopper website and download the latest version of GraphHopper.
• Extract the downloaded file to a location of your choice.

3. Configure GraphHopper

• Open the extracted folder and navigate to the config directory.
• Open the config.yml file using a text editor.

4. Adjust Configuration

• In the config.yml file, modify the following sections according to your preferences:
  • graph.flag_encoders: This will identify what kind of transportation you are routing for (e.g., car, bike, foot).
  • datareader.file: The OSM file you want to import (typically a .osm.pbf file).
  • graphhopper.graph.location: The directory where your graph data will be saved.
  • graphhopper.datareader.read_relations: Set this to false if you want to ignore relations in OSM file.
  • graphhopper.datareader.way_point_max_distance: This is the maximum distance between points to avoid inserting dense nodes.
• Save your changes.

5. Run GraphHopper

• Open a terminal window.
• Navigate to the extracted GraphHopper directory.
• Use the following command to start GraphHopper:

 ./graphhopper.sh web [path/to/your/config.yml]

• GraphHopper should start and be accessible via your web browser at http://localhost:8989/.

Congrats! You have successfully installed GraphHopper on your macOS system.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!