[[TranslatedPages]]
[[PageOutline(2-4,Table of Contents)]]
= Comparison between ​ELI and JOSM imagery lists =
== Documentation==
This page compares the imagery lists of the [https://github.com/osmlab/editor-imagery-index GitHub project Editor Layer Index] (former Editor Imagery Index) and [wikitr:/Maps JOSM] to find differences or problems with imageries. The following table explains what the different colors in the output below mean. If a red line can't be resolved it can be added to the [ImageryCompareIgnores ignore list]. There is also a more detailed reason for each ignore entry documented.

||= **Color** =||= **Description** =||= **Action** =||
||  [[span(style=color: black, black)]]  || [[span(style=color: black, informational texts)]] ||  ||
||  [[span(style=color: brown, brown)]]  || [[span(style=color: brown, entries in ELI but not in JOSM)]] || [[span(style=color: brown, should be checked and fixed or added to ignore list)]] ||
||  [[span(style=color: red, red)]]  || [[span(style=color: red, problems with JOSM entries)]] || [[span(style=color: red, should be checked and fixed)]] ||
||  [[span(style=color: brown, brown)]]  || [[span(style=color: brown, differences between ELI and JOSM)]] || [[span(style=color: brown, should be checked and fixed or added to ignore list)]] ||
||  [[span(style=color: blue, blue)]]  || [[span(style=color: blue, entries in JOSM but not in ELI)]] || [[span(style=color: blue, should be checked)]] ||
||  [[span(style=color: blue, blue)]]  || [[span(style=color: blue, problems with ELI entries)]] || [[span(style=color: blue, should be checked and fixed in ELI or added to ignore list)]] ||
||  [[span(style=color: green, green)]]  || [[span(style=color: green, entries which already have been checked and are on the ignore list (e.g. only minor style differences, or sync impossible))]] || [[span(style=color: green, no action required)]] ||
||  [[span(style=color: DarkGoldenrod, golden)]]  || [[span(style=color: DarkGoldenrod, entries which already have been checked and are on the ignore list (outdated in ELI))]] || [[span(style=color: DarkGoldenrod, should be fixed in ELI)]] ||
||  [[span(style=color: indigo, purple)]]  || [[span(style=color: indigo, different ids)]] || [[span(style=color: indigo, not yet decided how to proceed, see [ticket:14655#comment:60])]] ||
||  [[span(style=color: orange, yellow)]]  || [[span(style=color: orange, new checks in test phase)]] || [[span(style=color: orange, should be checked and fixed if applicable)]] ||
||  [[span(style=color: brown, brown)]]  || [[span(style=color: brown, +++ Obsolete skip entry: at the end of this list flags old entries of the ignore list, which are no longer applicable)]] || [[span(style=color: brown, should be removed from the ignore list)]] ||

This [source:josm/trunk/scripts/SyncEditorLayerIndex.java script] compares the following properties:
* source URL
* type (WMS/TMS/WMTS)
* name
* min_zoom and max_zoom
* country code
* shapes (coordinates are rounded to 5 decimal digits for the comparison process)
* icon (ELI [https://github.com/osmlab/editor-layer-index/commit/9745988dcd177e4d4c32b41e715a7abe6a10c61e "unembedded"] icons, which were stored as data URL before, so these icons are no longer comparable by the script.)
* best
* date
* copyright/attribution information (permission-ref and terms-of-use-url (JOSM) both map to license_url (ELI))
* projections
* description
* id
* default
* overlay
* no-tile-header
* category
* privacy-policy-url

This script first tries to find matching URLs and in the remaining data it tries to find matching IDs. Everything left will be reported.
The script does not compare all special properties which are available in only one of the two databases.

ELI-only properties according to [https://github.com/osmlab/editor-layer-index/blob/gh-pages/schema.json ELI-schema] are:
* i18n (see #18684)
* permission_osm

JOSM-only properties according to [wiki:/Maps#Documentation JOSM-schema] are:

* logo-url
* mirror

The script also does not yet compare the following properties as they are not yet actively used in ELI:

* eula
* logo-image
* terms-of-use-text
* no-tile-checksum
* metadata-header
* valid-georeference
* tile-size
* mod-tile-features
* custom-http-headers
* default-layers
* format
* transparent
* minimum-tile-expire

For entries of the kind "... differs ('aaa' != 'bbb')", the first variant (aaa) is ELI and the second (bbb) JOSM.

The files actually used for the comparison are [/maps maps] and [https://github.com/osmlab/editor-layer-index/raw/gh-pages/imagery.geojson imagery.geojson].

For easier syncing between JOSM and ELI there are two features:
* [/maps?format=geojson&pretty=true This] file displays the JOSM database in ELIs geojson format. Note that this file may contain JOSM-only properties (see above) which are not (yet) supported by the ELI schema. Possibly you need to remove these properties when syncing to ELI. Also note that terms-of-use-url isn't converted to license_url in the geojson output.
* The command `ant dist imageryindexdownload` in the JOSM svn repository produces several files including `imagery_eliout.imagery.xml` which is the ELI database in JOSMs xml format. (ELI has an XML output too, but it is without the indentation JOSM uses in the wiki, which makes syncing hard.)

New data is usually taken into account within a few seconds after a JOSM wiki edit or the ELI traviscibot completed his work. (You need to reload this page then to update the comparison script.)

== Results ==
Current number of entries for each type: [[ImageryCompare(stats)]]

See [#OnlyErrors below] for the summary of all new, unresolved issues.

[[ImageryCompare]]

== Only Errors == #OnlyErrors
The following list summarizes all red entries (i.e. new, unresolved issues) from the large list above. There should be none.

[[ImageryCompare(error)]]