ilja_space/MapComplete
1
0
Fork 0
forked from MapComplete/MapComplete
Code Pull requests Activity

Docs: finish creating the overview of all online services

Browse source
This commit is contained in:
Pieter Vander Vennet 2025-06-29 22:42:28 +02:00
parent e9209f6b7c
commit 2361fe5e83
17 changed files with 177 additions and 94 deletions
Download patch file Download diff file Expand all files Collapse all files

110
Docs/OnlineServicesOverview.md
View file

@ -2,14 +2,18 @@
# Overview of used online services
This document list all the hosts that MapComplete might contact via 'fetch'-requests for various API services. We do our best to use FLOSS- and/or self-hostable services as much as possible.
## Table of contents
1. [core](#core)
- [About displayed images](#about-displayed-images)
- [geofabrik.de](#geofabrikde)
- [imgur.com](#imgurcom)
- [komoot.io](#komootio)
- [mapcomplete.org](#mapcompleteorg)
- [mapillary.com](#mapillarycom)
- [openstreetmap.fr](#openstreetmapfr)
- [openstreetmap.org](#openstreetmaporg)
- [osm.jp](#osmjp)
- [overpass-api.de](#overpass-apide)
@ -17,6 +21,9 @@
- [private.coffee](#privatecoffee)
- [wikimedia.org](#wikimediaorg)
2. [feature](#feature)
- [flickr.com](#flickrcom)
- [mangrove.reviews](#mangrovereviews)
- [maproulette.org](#maprouletteorg)
- [ovh.net](#ovhnet)
- [plantnet.org](#plantnetorg)
- [velopark.be](#veloparkbe)
@ -24,9 +31,13 @@
3. [maplayer](#maplayer)
4. [No category](#no-category)
Some of the core services (especially Panoramax and MapLibre) could be selfhosted, but MapComplete has no support for a user to configure a different host. Right now, the userbase is relatively small and there is little demand to make this configurable, but the technical cost for this is quite high. Someone who wishes to use a different service, is able to build a fork.
One service that is hard to replace, is [*Mapillary*](https://wiki.openstreetmap.org/wiki/Mapillary). It contains a vast trove of streetview data, but cannot be selfhosted and is currently owned by Meta Inc. We use this to find nearby images of features, but promote the use of [Panoramax](https://wiki.openstreetmap.org/wiki/Panoramax) instead (both by uploading contributions to our panoramax-instance and by lobbying in the community for this)
## core
20 items
23 items
Core features are always active and will be contacted as soon as you visit any map
@ -42,6 +53,14 @@ Nominatim search engine endpoint, used when searching
-----|----- |
| https://geocoding.geofabrik.de/b75350b1cfc34962ac49824fe5b582dc/ | OpenData, source available, self hostable, https://wiki.openstreetmap.org/wiki/Nominatim |
### imgur.com
[Legacy] If an image is stored on imgur, read the description and attempt to get a license out of it. Most (if not all) have moved
| source |
----- |
| https://api.imgur.com/3/image |
### komoot.io
Endpoint for search with photon
@ -60,18 +79,24 @@ Endpoint for search with photon
| https://report.mapcomplete.org/report | If a severe error occurs in MapComplete, this is logged on this server - this mostly concerns errors where making a change to OpenStreetMap failed. Data is handled confidentially and _only_ to replay the change and fix the root cause. | OpenData, yes, |
| https://countrycoder.mapcomplete.org | For quite some functions, we need to know in what _country_ a feature is located. LatLon2Country is a static dataset, which, by cleverly encoding the data, can quickly tell in what country a feature is located. | OpenData, source available, self hostable, https://source.mapcomplete.org/MapComplete/latlon2country |
| https://data.mapcomplete.org/nsi | Contains a copy and the logos of the Name Suggestion Index | |
| https://panoramax.mapcomplete.org | The panoramax-server that MapComplete uploads to | OpenData, source available, self hostable, https://wiki.openstreetmap.org/wiki/Panoramax |
| https://panoramax.mapcomplete.org | Various endpoints to load images from panoramax | OpenData, source available, self hostable, |
| https://lod.mapcomplete.org/extractgraph?url={url} | This proxy queries websites to detect if they contain linked open data and gives this data back. Triggered by opening a feature | OpenData, source available, self hostable, https://source.mapcomplete.org/MapComplete/MapComplete/src/branch/develop/scripts/serverLdScrape.ts |
### mapillary.com
Mapillary is an online service which hosts streetview-imagery. It is used to query and show nearby images. Owned by Meta Inc. (Facebook). MapComplete does only use data, but does not recommend contributing data to Mapillary (instead, we recommend uploading to a panoramax-instance)
| source | description | license;selfhosting;more info |
-----|-----|----- |
| https://graph.mapillary.com | API endpoint of Mapillary to query which images are nearby | OpenData, https://wiki.openstreetmap.org/wiki/Mapillary |
| https://mapillary.com | Mapillary is an online service which hosts streetview-imagery. It is used to query and show nearby images. Owned by Meta Inc. (Facebook). MapComplete does only use data, but does not recommend contributing data to Mapillary (instead, we recommend uploading to a panoramax-instance) | OpenData, proprietary server, https://www.mapillary.com/about , https://wiki.openstreetmap.org/wiki/Mapillary |
| https://www.mapillary.com | Mapillary is an online service which hosts streetview-imagery. It is used to query and show nearby images. Owned by Meta Inc. (Facebook). MapComplete does only use data, but does not recommend contributing data to Mapillary (instead, we recommend uploading to a panoramax-instance) | OpenData, proprietary server, https://www.mapillary.com/about , https://wiki.openstreetmap.org/wiki/Mapillary |
### openstreetmap.fr
Various endpoints to load images from panoramax
| source | license;selfhosting;more info |
-----|----- |
| https://mapillary.com | OpenData, proprietary server, https://www.mapillary.com/about , https://wiki.openstreetmap.org/wiki/Mapillary |
| https://www.mapillary.com | OpenData, proprietary server, https://www.mapillary.com/about , https://wiki.openstreetmap.org/wiki/Mapillary |
| https://graph.mapillary.com | OpenData, proprietary server, https://www.mapillary.com/about , https://wiki.openstreetmap.org/wiki/Mapillary |
| https://panoramax.openstreetmap.fr | OpenData, source available, self hostable, |
### openstreetmap.org
@ -99,11 +124,10 @@ Overpass is a query service where OpenStreetMap-data can be retrieved. Various o
### panoramax.xyz
The federation instance of Panoramax, which knows all panoramax-servers and can query all servers
| source | license;selfhosting;more info |
-----|----- |
| https://panoramax.xyz | OpenData, source available, self hostable, https://wiki.openstreetmap.org/wiki/Panoramax |
| source | description | license;selfhosting;more info |
-----|-----|----- |
| https://api.panoramax.xyz | Various endpoints to load images from panoramax | OpenData, source available, self hostable, |
| https://panoramax.xyz | The federation instance of Panoramax, which knows all panoramax-servers and can query all servers | OpenData, source available, self hostable, https://wiki.openstreetmap.org/wiki/Panoramax |
### private.coffee
@ -124,10 +148,34 @@ Wikimedia contains various images
## feature
15 items
10 items
These are only enabled for certain maps or certain features
### flickr.com
API endpoint to fetch 'nearby images'
| source | license;selfhosting;more info |
-----|----- |
| https://api.flickr.com | OpenData, |
### mangrove.reviews
Mangrove.reviews, part of the 'Open Review Association' allows to create reviews. All reviews are under a creative commons license
| source | license;selfhosting;more info |
-----|----- |
| https://api.mangrove.reviews | OpenData, source available, selfhostable, but network effects diminish the value, https://gitlab.com/open-reviews/mangrove , https://mangrove.reviews/ , https://wiki.openstreetmap.org/wiki/Open_Reviews_Association |
### maproulette.org
[MapRoulette](https://wiki.openstreetmap.org/wiki/MapRoulette) is a platform where tasks can be submitted, where every task contains some data about something that should be improved in OpenStreetMap. The intent is that those 'tasks' are solved by the community, effectively working as big, shared 'todo'-list. MapComplete can display such tasks and mark them solved. This is most often done to run an import of data.
| source | license;selfhosting;more info |
-----|----- |
| https://maproulette.org/api/v2 | OpenData, source available, self hostable, |
### ovh.net
The image data store for a French Panoramax-server. As the photosphere fetches this, must be listed in the CSP
@ -162,14 +210,6 @@ MapComplete checks wikidata to find images to show and displays information from
| https://wikidata.org/ | OpenData, source available, yes, but useless due to network effects, |
| https://query.wikidata.org | OpenData, source available, yes, but useless due to network effects, |
| https://m.wikidata.org | OpenData, source available, yes, but useless due to network effects, |
| https://www.wikidata.org/ | OpenData, source available, yes, but useless due to network effects, |
| https://wikidata.org/ | OpenData, source available, yes, but useless due to network effects, |
| https://query.wikidata.org | OpenData, source available, yes, but useless due to network effects, |
| https://m.wikidata.org | OpenData, source available, yes, but useless due to network effects, |
| https://www.wikidata.org/ | OpenData, source available, yes, but useless due to network effects, |
| https://wikidata.org/ | OpenData, source available, yes, but useless due to network effects, |
| https://query.wikidata.org | OpenData, source available, yes, but useless due to network effects, |
| https://m.wikidata.org | OpenData, source available, yes, but useless due to network effects, |
## maplayer
@ -446,35 +486,7 @@ A full listing can be found in [ELI-overview](ELI-overview.md)
## No category
27 items
- https://www.openstreetmap.org
- https://api.openstreetmap.org
- https://panoramax.mapcomplete.org
- https://api.flickr.com
- https://api.imgur.com/3/image
- https://i.imgur.com
- *.fbcdn.net
- https://graph.mapillary.com
- https://panoramax.openstreetmap.fr
- https://api.panoramax.xyz
- https://panoramax.mapcomplete.org
- https://api.imgur.com/3/image
- https://panoramax.mapcomplete.org
- https://www.openstreetmap.org
- https://www.openstreetmap.org
- https://www.openstreetmap.org
- https://api.imgur.com/3/image
- https://i.imgur.com
- https://www.openstreetmap.org
- https://www.openstreetmap.org
- https://api.mangrove.reviews
- https://api.mangrove.reviews
- https://api.mangrove.reviews
- https://maproulette.org/api/v2
- *.wikipedia.org
- https://countrycoder.mapcomplete.org
- https://www.openstreetmap.org
0 items