Skip to contents

Returns the existing notes in the specified bounding box. The notes will be ordered by the date of their last change, the most recent one will be first.

Usage

osm_read_bbox_notes(
  bbox,
  limit = 100,
  closed = 7,
  format = c("R", "sf", "xml", "rss", "json", "gpx")
)

Arguments

bbox

Coordinates for the area to retrieve the notes from (left,bottom,right,top). Floating point numbers in degrees, expressing a valid bounding box, not larger than the configured size limit, 25 square degrees, not overlapping the dateline.

limit

Specifies the number of entries returned at max. A value between 1 and 10000 is valid. Default to 100.

closed

Specifies the number of days a note needs to be closed to no longer be returned. A value of 0 means only open notes are returned. A value of -1 means all notes are returned. Default to 7.

format

Format of the output. Can be "R" (default), "sf" "xml", "rss", "json" or "gpx".

Value

If format = "R", returns a data frame with one map note per row. If format = "sf", returns a sf object from sf.

format = "xml"

Returns a xml2::xml_document with the following format:

<?xml version="1.0" encoding="UTF-8"?>
<osm version="0.6" generator="OpenStreetMap server" copyright="OpenStreetMap and contributors" attribution="https://www.openstreetmap.org/copyright" license="https://opendatacommons.org/licenses/odbl/1-0/">
  <note lon="0.1000000" lat="51.0000000">
    <id>16659</id>
    <url>https://master.apis.dev.openstreetmap.org/api/0.6/notes/16659</url>
    <comment_url>https://master.apis.dev.openstreetmap.org/api/0.6/notes/16659/comment</comment_url>
    <close_url>https://master.apis.dev.openstreetmap.org/api/0.6/notes/16659/close</close_url>
    <date_created>2019-06-15 08:26:04 UTC</date_created>
    <status>open</status>
    <comments>
      <comment>
        <date>2019-06-15 08:26:04 UTC</date>
        <uid>1234</uid>
        <user>userName</user>
        <user_url>https://master.apis.dev.openstreetmap.org/user/userName</user_url>
        <action>opened</action>
        <text>ThisIsANote</text>
        <html>&lt;p&gt;ThisIsANote&lt;/p&gt;</html>
      </comment>
      ...
    </comments>
  </note>
  ...
</osm>

format = "json"

Returns a list with the following json structure:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {"type": "Point", "coordinates": [0.1000000, 51.0000000]},
      "properties": {
        "id": 16659,
        "url": "https://master.apis.dev.openstreetmap.org/api/0.6/notes/16659.json",
        "comment_url": "https://master.apis.dev.openstreetmap.org/api/0.6/notes/16659/comment.json",
        "close_url": "https://master.apis.dev.openstreetmap.org/api/0.6/notes/16659/close.json",
        "date_created": "2019-06-15 08:26:04 UTC",
        "status": "open",
        "comments": [
          {"date": "2019-06-15 08:26:04 UTC", "uid": 1234, "user": "userName", "user_url": "https://master.apis.dev.openstreetmap.org/user/userName", "action": "opened", "text": "ThisIsANote", "html": "<p>ThisIsANote</p>"},
          ...
        ]
      }
    }
  ]
}

format = "rss" & format = "gpx"

For format in "rss", and "gpx", a xml2::xml_document with the corresponding format.

Note

The comment properties (uid, user, user_url) will be omitted if the comment was anonymous.

See also

Other get notes' functions: osm_feed_notes(), osm_get_notes(), osm_search_notes()

Examples

notes <- osm_read_bbox_notes(bbox = c(3.7854767, 39.7837403, 4.3347931, 40.1011851), limit = 10)
## bbox as a character value also works (bbox = "3.7854767,39.7837403,4.3347931,40.1011851").
notes
#>          lon        lat      id
#> 1  4.2705990 39.9498139 4707249
#> 2  4.3022659 39.8648990 4650892
#> 3  4.3026763 39.8650801 4650872
#> 4  4.2588437 39.8876073 4650867
#> 5  4.2593747 39.8868666 4650857
#> 6  4.2590743 39.8878090 4650847
#> 7  4.1320450 39.9870800 4599282
#> 8  4.1320825 39.9870695 4597556
#> 9  4.0306306 39.9304800 4550319
#> 10 4.2930578 39.8782652 4512700
#>                                                        url
#> 1  https://api.openstreetmap.org/api/0.6/notes/4707249.xml
#> 2  https://api.openstreetmap.org/api/0.6/notes/4650892.xml
#> 3  https://api.openstreetmap.org/api/0.6/notes/4650872.xml
#> 4  https://api.openstreetmap.org/api/0.6/notes/4650867.xml
#> 5  https://api.openstreetmap.org/api/0.6/notes/4650857.xml
#> 6  https://api.openstreetmap.org/api/0.6/notes/4650847.xml
#> 7  https://api.openstreetmap.org/api/0.6/notes/4599282.xml
#> 8  https://api.openstreetmap.org/api/0.6/notes/4597556.xml
#> 9  https://api.openstreetmap.org/api/0.6/notes/4550319.xml
#> 10 https://api.openstreetmap.org/api/0.6/notes/4512700.xml
#>                                                        comment_url
#> 1  https://api.openstreetmap.org/api/0.6/notes/4707249/comment.xml
#> 2                                                             <NA>
#> 3  https://api.openstreetmap.org/api/0.6/notes/4650872/comment.xml
#> 4  https://api.openstreetmap.org/api/0.6/notes/4650867/comment.xml
#> 5  https://api.openstreetmap.org/api/0.6/notes/4650857/comment.xml
#> 6  https://api.openstreetmap.org/api/0.6/notes/4650847/comment.xml
#> 7  https://api.openstreetmap.org/api/0.6/notes/4599282/comment.xml
#> 8  https://api.openstreetmap.org/api/0.6/notes/4597556/comment.xml
#> 9  https://api.openstreetmap.org/api/0.6/notes/4550319/comment.xml
#> 10 https://api.openstreetmap.org/api/0.6/notes/4512700/comment.xml
#>                                                        close_url
#> 1  https://api.openstreetmap.org/api/0.6/notes/4707249/close.xml
#> 2                                                           <NA>
#> 3  https://api.openstreetmap.org/api/0.6/notes/4650872/close.xml
#> 4  https://api.openstreetmap.org/api/0.6/notes/4650867/close.xml
#> 5  https://api.openstreetmap.org/api/0.6/notes/4650857/close.xml
#> 6  https://api.openstreetmap.org/api/0.6/notes/4650847/close.xml
#> 7  https://api.openstreetmap.org/api/0.6/notes/4599282/close.xml
#> 8  https://api.openstreetmap.org/api/0.6/notes/4597556/close.xml
#> 9  https://api.openstreetmap.org/api/0.6/notes/4550319/close.xml
#> 10 https://api.openstreetmap.org/api/0.6/notes/4512700/close.xml
#>           date_created status
#> 1  2025-04-12 14:50:58   open
#> 2  2025-03-04 11:19:37 closed
#> 3  2025-03-04 11:13:40   open
#> 4  2025-03-04 11:11:19   open
#> 5  2025-03-04 11:06:36   open
#> 6  2025-03-04 11:01:28   open
#> 7  2025-01-23 18:15:55   open
#> 8  2025-01-22 10:49:05   open
#> 9  2024-12-11 13:31:22   open
#> 10 2024-11-09 08:41:50   open
#>                                                    comments
#> 1                     1 comment from 2025-04-12 by glimgran
#> 2  2 comments from 2025-03-04 to 2025-04-11 by NA, cronoser
#> 3               1 comment from 2025-03-04 by anonymous user
#> 4               1 comment from 2025-03-04 by anonymous user
#> 5               1 comment from 2025-03-04 by anonymous user
#> 6               1 comment from 2025-03-04 by anonymous user
#> 7               1 comment from 2025-01-23 by anonymous user
#> 8                 1 comment from 2025-01-22 by Pan Perníček
#> 9                 1 comment from 2024-12-11 by Pan Perníček
#> 10              1 comment from 2024-11-09 by Hector Asencio