1OSMIUM-QUERY-LOCATIONS-INDEX(1)                OSMIUM-QUERY-LOCATIONS-INDEX(1)
2
3
4

NAME

6       osmium-query-locations-index - query node locations index
7

SYNOPSIS

9       osmium query-locations-index -i INDEX-FILE [OPTIONS] NODE-ID
10       osmium query-locations-index -i INDEX-FILE [OPTIONS] --dump
11

DESCRIPTION

13       Get the location of a node from an index created with osmium create-lo‐
14       cations-index or dump the whole index into an OSM file.
15
16       The index file format is compatible to the one created by “osmium  add-
17       location-to-ways  -i  dense_file_array,INDEX-FILE”  and to the flatnode
18       store created by osm2pgsql.
19
20       This command will not work with negative node IDs.
21
22       Note that when the --dump option is used, metadata (like version, time‐
23       stamp, etc.)  is not written to the output file because it is all empty
24       anyway.  Use the --output-format/-f  option  with  add_metadata=...  to
25       overwrite this.
26

OPTIONS

28       --dump Dump all node locations to an OSM file.  Use the --output/-o and
29              --output-format/-f options to set the file format  to  be  used.
30              Default is STDOUT and the OPL format, respectively.
31
32       -i, --index-file=FILENAME
33              The name of the index file.
34

COMMON OPTIONS

36       -h, --help
37              Show usage help.
38
39       -v, --verbose
40              Set  verbose  mode.   The  program will output information about
41              what it is doing to STDERR.
42

OUTPUT OPTIONS

44       -f, --output-format=FORMAT
45              The format of the output file.  Can be used to  set  the  output
46              file  format  if  it  can’t be autodetected from the output file
47              name.  See osmium-file-formats(5) or the  libosmium  manual  for
48              details.
49
50       --fsync
51              Call  fsync after writing the output file to force flushing buf‐
52              fers to disk.
53
54       --generator=NAME
55              The name and version of the program generating the output  file.
56              It  will  be added to the header of the output file.  Default is
57              “osmium/” and the version of osmium.
58
59       -o, --output=FILE
60              Name of the output file.  Default is `-' (STDOUT).
61
62       -O, --overwrite
63              Allow an existing output file to be overwritten.   Normally  os‐
64              mium will refuse to write over an existing file.
65
66       --output-header=OPTION=VALUE
67              Add  output header option.  This command line option can be used
68              multiple times for different OPTIONs.   See  the  osmium-output-
69              headers(5) man page for a list of available header options.  For
70              some commands you can use the special format “OPTION!” (ie.   an
71              exclamation  mark  after the OPTION and no value set) to set the
72              value to the same as in the input file.
73

DIAGNOSTICS

75       osmium query-locations-index exits with exit code
76
77       0      if everything went alright and the node location was found,
78
79       1      if the node location was not found,
80
81       2      if there was a problem with the command line arguments.
82

MEMORY USAGE

84       osmium query-locations-index will not use a lot of memory.
85

EXAMPLES

87       Get location of node 1234 from locations.idx:
88
89              osmium query-locations-index -i locations.idx 1234
90
91       Dump contents of locations.idx into an OPL file:
92
93              osmium query-locations-index -i locations.idx --dump -o nodes.opl
94

SEE ALSO

96       • osmium(1), osmium-create-locations-index(1),  osmium-file-formats(5),
97         osmium-output-headers(5)
98
99       • Osmium website (https://osmcode.org/osmium-tool/)
100
101       • osm2pgsql (https://wiki.openstreetmap.org/wiki/Osm2pgsql)
102

104       Copyright (C) 2013-2023 Jochen Topf <jochen@topf.org>.
105
106       License  GPLv3+:  GNU  GPL  version  3  or  later  <https://gnu.org/li‐
107       censes/gpl.html>.  This is free software: you are free  to  change  and
108       redistribute it.  There is NO WARRANTY, to the extent permitted by law.
109

CONTACT

111       If  you  have  any  questions  or  want  to  report a bug, please go to
112       https://osmcode.org/contact.html
113

AUTHORS

115       Jochen Topf <jochen@topf.org>.
116
117
118
119                                    1.16.0     OSMIUM-QUERY-LOCATIONS-INDEX(1)
Impressum