2b:null 2c:["$","title",null,{"children":"OSM Overpass API | Etienne de Boursetty | Observable"}] 31:Tc15,md`## Overpass QL To construct your own queries, refer to the [Overpass QL reference documentation](https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL). ### overview * [Overpass Query Language (QL) overview](https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL#Language_overview) -- openstreetmap.org * Overpass QL manipulates sets. * A set may contain any combination of nodes, ways, relations, and area elements. * A [node](https://wiki.openstreetmap.org/wiki/Node) is a single point defined by its lat, lon and id * A [way](https://wiki.openstreetmap.org/wiki/Way) is an ordered list of nodes (a linear feature) * A [relation](https://wiki.openstreetmap.org/wiki/Relation) is a group of elements -- an ordered list of one or more nodes, ways and relations * An [area](https://wiki.openstreetmap.org/wiki/Area) is a closed way * [Language structure](https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL#Language_structure) * there are: (1) settings, (2) block statements, (3) standalone queries. ### settings * Overpass QL settings must be declared in the first uncommented statement * Not multiple statements * Declarations are enclosed in brackets [] * A colon : appears between the setting name and its value or values * The statement must be terminated with a semicolon ; * Ref: [Overpass QL settings](https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL#Settings) -- openstreetmap.org * [maxsize](https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL#Element_limit_.28maxsize:.29) * Maximum allowed memory in bytes. Default value is 536870912 (512 MB) * [out](https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL#Output_Format_.28out:.29) * Output format (unrelated to the "out" statement) * For example: "json", "csv" (there are others) * [bbox](https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL#Global_bounding_box_.28bbox.29) * Global bounding box (the "setting" is distinct from the bbox "query") * For example: [bbox:south, west, north, east] * [timeout](https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL#timeout:) * Maximum allowed runtime for the query (seconds). Default is 180. * Large values may be rejected by the server. ### standalone queries * out; -- output contents of a set (almost always used) * [>; recurse down](https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL#Recurse_down_.28.3E.29) * takes an input set and produces a result set * includes all nodes and ways that are members of a relation in the input set * see the documentation for more detail * out body; -- print all information necessary to use the data (default) * for geolocated information (default is to print none)... * out geom; -- add a full geometry to each object * out skel; -- print minimum information for geometry * out center; -- adds only the center of the bounding box to ways and relations ### query-overpass [query-overpass](https://www.npmjs.com/package/query-overpass) returns GeoJSON from an API query written with Overpass QL `32:T4b1,queries = ({ ProtectedAreas: `[out:json]; relation [boundary=protected_area][landuse=forest][type=multipolygon] (22.254407734234842, -120.44416870774663,47.988287580870235, -58.83185878485484); out; >; out skel;`, CentralPark: `[out:json]; node[amenity=bench](40.76813305634191, -73.98166954090348,40.796659991781155, -73.9494584099196); out;`, BaltimoreBars: `[out:json][timeout:25][bbox:39.275296,-76.613381,39.294396,-76.559651]; node["amenity"="bar"]; out; >; out geom;`, Dabo: `[out:json]; ( way ["tourism"="attraction"][name] (48.524563354035,7.0391464233398,48.79035455869,7.5101852416992); node ["tourism"="attraction"][name] (48.524563354035,7.0391464233398,48.79035455869,7.5101852416992); way ["amenity"="place_of_worship"] (48.524563354035,7.0391464233398,48.79035455869,7.5101852416992); node ["amenity"="place_of_worship"][name] (48.524563354035,7.0391464233398,48.79035455869,7.5101852416992); way ["historic"][name] (48.524563354035,7.0391464233398,48.79035455869,7.5101852416992); node ["historic"][name] (48.524563354035,7.0391464233398,48.79035455869,7.5101852416992); ); out; >; out skel;` })33:[] 2f:{"id":"360b14e0e793689f","slug":null,"title":"OSM Overpass API","thumbnail":"6d10c8cd3db61909e22b9219b65cc8270ae834b373077dd8b83a4456f3b61f4b","access_level":"public","create_time":"$D2023-01-20T22:50:27.261Z","update_time":"$D2023-01-20T23:08:13.423Z","view_time":null,"first_public_time":"$D2023-01-20T22:50:27.261Z","fork":{"id":"d84498178c4af85f","slug":"osm-overpass-api","title":"OSM Overpass API","owner":{"id":"7516093edf6f0c46","login":"lresh1","name":""}},"stars":0,"starred":false,"owner":{"type":"team","id":"f294bda2ffd5d5fb","login":"edeboursetty","name":"Etienne de Boursetty","avatar_url":"https://avatars-next.observableusercontent.com/a0272d0024c0c1b5d33843c0de1de4266c4a7e1aa596555d3792dd886207af5f","tier":"starter_2024"},"version":763,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"54f1c9ccbfb5ffc7","login":"edeboursetty","name":"Etienne de Boursetty","avatar_url":"https://avatars-next.observableusercontent.com/a0272d0024c0c1b5d33843c0de1de4266c4a7e1aa596555d3792dd886207af5f","tier":null}],"members":[{"type":"individual","id":"54f1c9ccbfb5ffc7","login":"edeboursetty","name":"Etienne de Boursetty","avatar_url":"https://avatars-next.observableusercontent.com/a0272d0024c0c1b5d33843c0de1de4266c4a7e1aa596555d3792dd886207af5f","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"title":"OSM Overpass API","cells":[{"id":551,"value":"md`# OSM Overpass API\n\nThis notebook uses the API to extract a small amount of OSM data.\n\nChoose one of the prepackaged queries, or type of your own.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":444,"value":"viewof choice = Radio([\"ProtectedAreas\", \"CentralPark\", \"BaltimoreBars\", \"Dabo\"], {value: 'Dabo', label: \"Choose a query:\"})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":349,"value":"viewof query = Textarea({\n label: \"OSM query\", \n rows: 7, \n placeholder: \"Type a query...\", submit: true})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":619,"value":"mutable report = html``","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":323,"value":"container = html`

`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":303,"value":"viewof rows = Table(geojson.features)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":644,"value":"rows","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":567,"value":"md`## map stuff`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":322,"value":"map = {\n const map = L.map(container).setView([39.74739, -105], 13);\n \n\tL.tileLayer('https://stamen-tiles-{s}.a.ssl.fastly.net/terrain/{z}/{x}/{y}{r}.png', {\n\t\tmaxZoom: 18,\n\t\tattribution: 'Map tiles by Stamen Design, under CC BY 3.0. Data by OpenStreetMap, under CC BY SA',\n\t\ttileSize: 512,\n\t\tzoomOffset: -1\n\t}).addTo(map);\n \n invalidation.then(() => map.remove()); // Clean up when re-running this cell\n return map;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":387,"value":"layer = {\n const style = {\n \"color\": \"green\",\n \"weight\": 10,\n \"opacity\": 0.25\n };\n \n function onEachFeature(feature, layer) {\n if (feature.properties && feature.properties.tags && feature.properties.tags.name) {\n layer.bindPopup(feature.properties.tags.name);\n } else {\n layer.bindPopup(feature.properties.type + \" id: \" + feature.properties.id)\n }\n }\n \n const layer = L.geoJSON([geojson], {\n\n style: style,\n onEachFeature: onEachFeature,\n\n\t\tpointToLayer: function (feature, latlng) {\n\t\t\treturn L.circleMarker(latlng, {\n\t\t\t\tradius: 4,\n\t\t\t\tfillColor: \"yellow\",\n stroke: \"black\",\n\t\t\t\tcolor: \"#000\",\n\t\t\t\tweight: 1,\n\t\t\t\topacity: 1,\n\t\t\t\tfillOpacity: 0.5\n\t\t\t});\n\t\t}\n\t}).addTo(map);\n \n map.fitBounds(layer.getBounds(), {padding: [20, 20]});\n \n invalidation.then(() => map.removeLayer(layer));\n return layer\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":240,"value":"$31","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":0,"value":"md`### References and other demos\n\n* [Overpass Boundary Queries](https://observablehq.com/@nzzeditotech/overpass-boundary-queries) uses [query-overpass](https://github.com/perliedman/query-overpass) -- observable\n* [Overpass API](https://observablehq.com/@rjsheperd/overpass-api) uses [encodeURIComponent()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent) -- observable\n* [Overpass turbo](https://wiki.openstreetmap.org/wiki/Overpass_turbo) (OSM data-mining tool) -- openstreetmap.org\n * Go to http://overpass-turbo.eu and try this...\n rel[\"ISO3166-2\"~\"^FR\"]\n [admin_level=4]\n [type=boundary]\n [boundary=administrative];\n out geom;`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":230,"value":"md`### Example queries\n\nThis is a boundary query for Switzerland that returns ~70 features\n\n [out:json];\n relation\n [boundary=administrative]\n [\"ISO3166-2\"~\"^CH\"];\n out; >; out skel;\n\nThis \"dc\" query returns ~1200 nodes\n\n [out:json];\n node(38.9072, -77.0369, 38.9102, -77.0339);\n out;\n\nThis \"denver\" query returns ~3K nodes:\n\n [out:json][timeout:25][bbox:45.4797,-122.7035, 45.5625,-122.6182];\n node[\"amenity\"=\"bicycle_parking\"];\n\n out; >; out geom;\n`\n","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":538,"value":"md`## OSM data`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":436,"value":"$32","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":300,"value":"geojson = queryOverpassGeoJSON(query)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":288,"value":"function queryOverpassGeoJSON(query) {\n mutable report = md`Please wait...`;\n return new Promise((resolve, reject) => {\n queryOverpass(query, (error, data) => {\n if (error) {\n mutable report = error;\n reject(error);\n } else {\n mutable report = md`${data.features.length} features returned.`;\n resolve(data);\n }\n });\n });\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":480,"value":"{ \n viewof query.value = choice ? queries[choice] : null;\n viewof query.dispatchEvent(new Event('input'))\n \n return md`#### UI \\n\\nWhen the user selects a query with the Radio button, this cell updates the TextArea.`\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":184,"value":"md`## Appendix`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":297,"value":"queryOverpass = require('https://bundle.run/query-overpass@1.5.5')","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":280,"value":"import {Textarea, Table, Radio} from \"@observablehq/inputs\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":6,"value":"d3 = require(\"d3@5\")","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":329,"value":"L = {\n const L = await require(\"leaflet@1/dist/leaflet.js\");\n if (!L._style) {\n const href = await require.resolve(\"leaflet@1/dist/leaflet.css\");\n document.head.appendChild(L._style = html``);\n }\n return L;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W33","stdlib":"1","titling":"auto"}} 30:"$2f:body"