Provided by: osmium-tool_1.16.0-1build1_amd64 bug

NAME
       osmium-query-locations-index - query node locations index


SYNOPSIS
       osmium query-locations-index -i INDEX-FILE [OPTIONS] NODE-ID
       osmium query-locations-index -i INDEX-FILE [OPTIONS] --dump


DESCRIPTION
       Get  the  location  of  a node from an index created with osmium create-locations-index or dump the whole
       index into an OSM file.

       The  index  file  format  is  compatible  to  the  one  created  by   “osmium   add-location-to-ways   -i
       dense_file_array,INDEX-FILE” and to the flatnode store created by osm2pgsql.

       This command will not work with negative node IDs.

       Note that when the --dump option is used, metadata (like version, timestamp, etc.)  is not written to the
       output  file  because it is all empty anyway.  Use the --output-format/-f option with add_metadata=... to
       overwrite this.


OPTIONS
       --dump Dump all node locations to an OSM file.  Use the --output/-o and --output-format/-f options to set
              the file format to be used.  Default is STDOUT and the OPL format, respectively.

       -i, --index-file=FILENAME
              The name of the index file.


COMMON OPTIONS
       -h, --help
              Show usage help.

       -v, --verbose
              Set verbose mode.  The program will output information about what it is doing to STDERR.


OUTPUT OPTIONS
       -f, --output-format=FORMAT
              The format of the output file.  Can be used  to  set  the  output  file  format  if  it  can’t  be
              autodetected  from  the  output file name.  See osmium-file-formats(5) or the libosmium manual for
              details.

       --fsync
              Call fsync after writing the output file to force flushing buffers to disk.

       --generator=NAME
              The name and version of the program generating the output file.  It will be added to the header of
              the output file.  Default is “osmium/” and the version of osmium.

       -o, --output=FILE
              Name of the output file.  Default is `-' (STDOUT).

       -O, --overwrite
              Allow an existing output file to be overwritten.  Normally osmium will refuse  to  write  over  an
              existing file.

       --output-header=OPTION=VALUE
              Add  output  header  option.   This  command  line option can be used multiple times for different
              OPTIONs.  See the osmium-output-headers(5) man page for a list of available header  options.   For
              some  commands you can use the special format “OPTION!” (ie.  an exclamation mark after the OPTION
              and no value set) to set the value to the same as in the input file.


DIAGNOSTICS
       osmium query-locations-index exits with exit code

       0      if everything went alright and the node location was found,

       1      if the node location was not found,

       2      if there was a problem with the command line arguments.


MEMORY USAGE
       osmium query-locations-index will not use a lot of memory.


EXAMPLES
       Get location of node 1234 from locations.idx:

              osmium query-locations-index -i locations.idx 1234

       Dump contents of locations.idx into an OPL file:

              osmium query-locations-index -i locations.idx --dump -o nodes.opl


SEE ALSO
       • osmium(1), osmium-create-locations-index(1), osmium-file-formats(5), osmium-output-headers(5)

       • Osmium website (https://osmcode.org/osmium-tool/)

       • osm2pgsql (https://wiki.openstreetmap.org/wiki/Osm2pgsql)


COPYRIGHT
       Copyright (C) 2013-2023 Jochen Topf <jochen@topf.org>.

       License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.  This is  free  software:
       you are free to change and redistribute it.  There is NO WARRANTY, to the extent permitted by law.


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


AUTHORS
       Jochen Topf <jochen@topf.org>.

                                                     1.16.0                      OSMIUM-QUERY-LOCATIONS-INDEX(1)