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     115 176923710 2026-01-07 00:00:58    pmolinero
#> 2 relation   349035    TRUE     171 174698142 2025-11-15 17:56:37    marcmarti
#> 3 relation   349053    TRUE     819 176140458 2025-12-19 13:15:59 jack walker2
#> 4 relation  2417889    TRUE      64 176140458 2025-12-19 13:15:59 jack walker2
#> 5 relation  2807397    TRUE     112 174698142 2025-11-15 17:56:37    marcmarti
#> 6 relation 11746917    TRUE     239 174698142 2025-11-15 17:56:37    marcmarti
#> 7 relation 11747082    TRUE     446 174698142 2025-11-15 17:56:37    marcmarti
#>        uid  lat  lon
#> 1 22408285 <NA> <NA>
#> 2 10355154 <NA> <NA>
#> 3 22831835 <NA> <NA>
#> 4 22831835 <NA> <NA>
#> 5 10355154 <NA> <NA>
#> 6 10355154 <NA> <NA>
#> 7 10355154 <NA> <NA>
#>                                                           members
#> 1 98 members: node/152364165/admin_centre, way/96647329/outer,...
#> 2 516 members: node/152364165/admin_centre, way/45319680/outer...
#> 3 2246 members: way/1415938360/outer, way/83094965/outer, way/...
#> 4 116 members: node/152364165/admin_centre, way/185724656/oute...
#> 5 450 members: node/152364165/admin_centre, way/45327666/outer...
#> 6 2219 members: node/152364165/admin_centre, way/585618147/out...
#> 7 3573 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 45 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     116 171306045 2025-09-01 09:50:59  Jordi MF
#>        uid  lat  lon
#> 1 15803602 <NA> <NA>
#> 2  8278438 <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 ...