From OpenStreetMap Wiki
< Tiles@home(Redirected from Tiles@home/API)
Jump to: navigation, search
Available languages — Tiles@home/APIs
Afrikaans Alemannisch aragonés asturianu azərbaycanca Bahasa Indonesia Bahasa Melayu Bân-lâm-gú Basa Jawa Baso Minangkabau bosanski brezhoneg català čeština dansk Deutsch eesti English español Esperanto estremeñu euskara français Frysk Gaeilge Gàidhlig galego Hausa hrvatski Igbo interlingua Interlingue isiXhosa isiZulu íslenska italiano Kiswahili Kreyòl ayisyen kréyòl gwadloupéyen Kurdî latviešu Lëtzebuergesch lietuvių magyar Malagasy Malti Nederlands Nedersaksies norsk bokmål norsk nynorsk occitan Oromoo oʻzbekcha/ўзбекча Plattdüütsch polski português português do Brasil română shqip slovenčina slovenščina Soomaaliga suomi svenska Tiếng Việt Türkçe Vahcuengh vèneto Wolof Yorùbá Zazaki српски / srpski беларуская български қазақша македонски монгол русский тоҷикӣ українська Ελληνικά Հայերեն ქართული नेपाली मराठी हिन्दी অসমীয়া বাংলা ਪੰਜਾਬੀ ગુજરાતી ଓଡ଼ିଆ தமிழ் తెలుగు ಕನ್ನಡ മലയാളം සිංහල ไทย မြန်မာဘာသာ ລາວ ភាសាខ្មែរ ⵜⴰⵎⴰⵣⵉⵖⵜ አማርኛ 한국어 日本語 中文(简体)‎ 吴语 粵語 中文(繁體)‎ ייִדיש עברית اردو العربية پښتو سنڌي فارسی ދިވެހިބަސް

This page describes some APIs for accessing tiles@home data on the tah server.

Using the map tiles

Map tile URLs are of the style: 1364.png, where the numbers are Z, X, and Y.

See Slippy map tilenames for details of what Z, X, and Y mean in this context (the same format as used in google maps, and in the other slippy map).

Get tile details

Returns tile metadata and shows the tile.

http://tah.openstreetmap.org/Browse/details/tile/12/2213/1195/ where tile is the "layer" name, and 12,2213,1195 are the Z,X,Y values of the tile.

Uploading tiles

HTTP POST request of a single ZIP file containing multiple tiles as 256x256 pixel opaque PNG images. Tiles must be uniquely named within the ZIP file, with names of the form tile_z_x_y.png, where z,x,y are as described in Slippy map tilenames. The ZIP file may contain subdirectories, these will be removed when it's received.

  • See [1] for an example of the field names
  • Example code at [2]

As upload credentials, use your OSM email and password. People who have upload passwords are listed at the Credits page.

Requesting updates

Go to http://tah.openstreetmap.org/Request/create/ and fill in the values (you can also send a HTTP POST form to that URL).

As a convenience you can also request a tile by calling an URL like that: http://tah.openstreetmap.org/Request/create/?x=1&y=2&priority=2

  • X,Y are Slippy map tilenames at zoom level 12
  • set priority=1 for time-sensitive requests, priority=2 for other requests, and priority=3 for large bulk requests which are not so urgent. Use the highest number possible here.
  • set src to a short description of your data source (up to 30 letters)
  • the URL will return one line of text indicating the result (e.g. "OK")

Websites which provide an interface for requesting updates:

Checking the requests queue


Example response:

  • Status - "OK" indicates that you're getting something from the script and not an error
  • X (at zoom 12)
  • Y (at zoom 12)
  • Machine-readable response
    • 0 = not in rendering queue
    • 1 = in rendering queue
  • Human-readable response
    • NOT_REQUESTED - tile update has never been requested
    • REQUESTED - tile update has been requested
    • RENDERING - tile update has been requested, and someone is processing the request
    • HISTORICAL - tile was requested in the past, but the results were already uploaded