Development Resources

• Maps source code

  The source code is stored in a git repository at GNOME's git database. Anyone can clone it using the following command:

  git clone https://gitlab.gnome.org/GNOME/gnome-maps.git

  Alternatively, you can download tarball archives of earlier Maps releases.

• Maps issue tracker

  Development in Maps is tracked using GNOME's issue tracker. Search the bugtracker for any issues or feature requests you may have. Feel free to work on fixing any bug filed against Maps.

• Making a release of Maps

• Running Maps in GDB

  In order to run gnome-maps in the gdb debugger, you need the following syntax:

  $ libtool --mode=execute gdb --args gjs /usr/bin/gnome-maps

• Guidelines for Git Commit Messages

  These are the recommended guidelines for GNOME Git commit messages.

• Maps design space

  The objectives of Maps as application. This is also the space for the current tentative design for implemented and upcoming aspects of Maps.

• GJS Style Guide

  Maps is written in Gjs (GNOME Javascript) and follows the general GJS style guide conventions. A must read if you are unfamiliar with GJS. GJS is an introspected language - for more information about how introspected languages work, check the GObject Introspection Project.

• geocode-glib Developer's Manual

  Maps uses geocode-glib to perform geocoding.

• libchamplain Developer's Manual

  Maps uses libchamplain to get the map widget ChamplainView.

• Nominatim

  Nominatim (from the Latin, 'by name') is a tool to search OSM data by name and address and to generate synthetic addresses of OSM points (reverse geocoding).

• GraphHopper

  A fast routing solution based on up-to-date OpenStreetMap data

• OpenTripPlanner

  Provides a range of passenger information and transportation network analysis features using our infrastructure for finding itineraries combining transit, pedestrian, bike, and car segments. More information here.

• Overpass

  The Overpass API (or OSM3S) is a read-only API that serves up custom selected parts of the OSM map data.

• Placing Labels (for Mapbox GL)

  Based on this paper

• Facebook

  • GFBGraph

• Foursquare

• Mapzen Data Plenty of useful GeoJSON files to download and test.

• Apps/Maps/Resources/GTFSFeeds List of GTFS feeds tested with OpenTripPlanner and the wip/mlundblad/transit-routing branch.

• Apps/Maps/PublicTransportation Information on the implementation of public transportation ("transit") in GNOME Maps.

1. Maps Developers

Most contributors to Maps hang out at #gnome-maps on irc.gnome.org. Contributors, users and developers are more than welcome to direct any questions about Maps there.