Skip to content

Latest commit

 

History

History
77 lines (48 loc) · 3.78 KB

FAQ.md

File metadata and controls

77 lines (48 loc) · 3.78 KB

How is "iD" pronounced?

Two syllables: "eye dee".

How can I help translate iD into another language or fix a mistranslation?

Please see CONTRIBUTING.md

How can I report an issue with background imagery?

To report an issue with missing or cloudy imagery:

  • For Mapbox Satellite layer: Use this imagery request tool to zoom to the location with the issue and draw a box around it.
  • For Bing Satellite layer: Open the location in Bing Maps, click the "Feedback" button and choose "Report a map problem" option.
  • For Esri World Imagery: You can open a new issue using the Imagery Map Feedback tool.

iD's list of available background imagery sources come from the editor-layer-index project. If you know of a more recent imagery source that is licensed for this use, please open a request there with the link and license details.

I'm having trouble seeing some of the colors. Is there a way to customize or change them?

Because iD uses CSS and SVG for all its rendering, users can override the colors with the Stylish extension on Firefox or Chrome. Stylish also allows users to share custom styles with others.

You can find detailed instructions on how to install Stylish here on learnosm.org.

See also: openstreetmap#3095 (comment)

Why not use canvas rather than SVG?

Using canvas rather than SVG would require implementing a scenegraph, hit-testing, event dispatch, animation, and other features provided natively by SVG. All that is a significant amount of work, would have meant a longer time for the initial release of iD, and would likely increase the ongoing costs of maintenance and new features.

On the other hand, SVG is already fast enough in many or most hardware/browser/OS/editing region combinations, and will only get faster as hardware improves and browser vendors optimize their implementations and take better advantage of hardware acceleration.

In other words, the decision to use SVG rather than canvas was a classic performance vs. implementation cost tradeoff with strong arguments for trading off performance to reduce implementation costs.

Can I use iD offline?

iD does not currently have an offline mode.

To support offline usage requires caching or providing an offline proxy for the three main things iD uses the network for:

  • Downloading existing data -- this is done on demand as you pan around
  • Downloading tiles -- ditto
  • Uploading changes

We've thought a little about caching tiles and downloaded data, but haven't actively worked on it, nor on the data download/upload question.

Can I use iD with my own OSM server?

Yes, you can. You will need to install and configure an instance of the Rails Port, the server that runs the OpenStreetMap website and API.

Once you have the Rails Port running, you may edit as normal using the version of iD that is bundled with it. Your changes will be saved to your own database. To use a standalone iD with your own api, you may edit the osm.js file.

Depending on your requirements, you may also want to set up cgimap and/or a tile rendering stack, but neither of these are required for editing with iD.