Skip to contents

Returns all (not deleted) relations in which the given object is used.

Usage

osm_relations_object(
  osm_type = c("node", "way", "relation"),
  osm_id,
  format = c("R", "xml", "json"),
  tags_in_columns = FALSE
)

Arguments

osm_type

Object type ("node", "way" or "relation").

osm_id

Object id represented by a numeric or a character value.

format

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

tags_in_columns

If FALSE (default), the tags of the objects are saved in a single list column tags containing a data.frame for each OSM object with the keys and values. If TRUE, add a column for each key. Ignored if format != "R".

Value

If format = "R", returns a data frame with one OSM object per row. If format = "xml", returns a xml2::xml_document following the OSM_XML format. If format = "json", returns a list with a json structure following the OSM_JSON format.

Examples

node <- osm_relations_object(osm_type = "node", osm_id = 152364165)
node
#>       type       id visible version changeset           timestamp         user
#> 1 relation   347950    TRUE     117 178474727 2026-02-12 20:37:51         ongn
#> 2 relation   349035    TRUE     176 178280474 2026-02-08 19:16:40    Đuro Jiří
#> 3 relation   349053    TRUE     824 178280474 2026-02-08 19:16:40    Đuro Jiří
#> 4 relation  2417889    TRUE      64 176140458 2025-12-19 13:15:59 jack walker2
#> 5 relation  2807397    TRUE     117 178280474 2026-02-08 19:16:40    Đuro Jiří
#> 6 relation 11746917    TRUE     244 178280474 2026-02-08 19:16:40    Đuro Jiří
#> 7 relation 11747082    TRUE     454 178586535 2026-02-15 15:16:04     jmaspons
#>        uid  lat  lon
#> 1  6255481 <NA> <NA>
#> 2 14617702 <NA> <NA>
#> 3 14617702 <NA> <NA>
#> 4 22831835 <NA> <NA>
#> 5 14617702 <NA> <NA>
#> 6 14617702 <NA> <NA>
#> 7 11725140 <NA> <NA>
#>                                                           members
#> 1 98 members: node/152364165/admin_centre, way/96647329/outer,...
#> 2 532 members: node/152364165/admin_centre, way/45319680/outer...
#> 3 2262 members: way/1415938360/outer, way/83094965/outer, way/...
#> 4 116 members: node/152364165/admin_centre, way/185724656/oute...
#> 5 466 members: node/152364165/admin_centre, way/45327666/outer...
#> 6 2235 members: node/152364165/admin_centre, way/585618147/out...
#> 7 3586 members: node/8000963558/label, node/152364165/admin_ce...
#>                                                                                  tags
#> 1   38 tags: admin_level=8 | alt_name:gl=Barna | alt_name:hi=बार्सेलोना | border_typ...
#> 2 35 tags: admin_level=6 | alt_name:br=Barselona | boundary=administrative | ine:p...
#> 3 71 tags: admin_level=4 | alt_name:el=Καταλονία | alt_name:eo=Katalunujo | alt_na...
#> 4 25 tags: admin_level=7 | border_type=comarca | boundary=administrative | name=Ba...
#> 5 13 tags: boundary=political | idescat:àmbit=01 | name=Àmbit metropolità | name:a...
#> 6 10 tags: boundary=political | default_language=ca | name=Català com a llengua pr...
#> 7 46 tags: boundary=political | name=Països Catalans | name:an=Países Catalans | n...

way <- osm_relations_object(osm_type = "way", osm_id = 372011578)
way
#>       type      id visible version changeset           timestamp
#> 1 relation 5524720    TRUE      58 172255804 2025-09-21 16:38:27
#>                user     uid  lat  lon
#> 1 Hugoren Martinako 3392826 <NA> <NA>
#>                                                           members
#> 1 193 members: relation/6959819/alternative, way/372006138/, w...
#>                                                                                  tags
#> 1 9 tags: distance=62.65 | name=Sender dels Maquis | network=nwn | operator=GR | o...

rel <- osm_relations_object(osm_type = "relation", osm_id = 342792)
rel
#>       type       id visible version changeset           timestamp      user
#> 1 relation   349012    TRUE     135 176378088 2025-12-24 22:28:24 michalgwo
#> 2 relation 11739086    TRUE     117 178024304 2026-02-02 20:59:42 Đuro Jiří
#>        uid  lat  lon
#> 1 15803602 <NA> <NA>
#> 2 14617702 <NA> <NA>
#>                                                           members
#> 1 495 members: node/21323935/admin_centre, way/1153082462/oute...
#> 2 1038 members: node/34105607/admin_centre, node/8000963555/la...
#>                                                                                  tags
#> 1 35 tags: admin_level=6 | alt_name:gl=Alacante | border_type=province | boundary=...
#> 2 52 tags: boundary=political | default_language=ca | name=Municipis de Predomini ...