Skip to content

Geotag images by the default sources when only --video_geotag_source is given - #865

Merged
caglarpir merged 3 commits into
mapillary:mainfrom
caglarpir:default-image-sources-with-video-source
Oct 22, 2026
Merged

caglarpir merged 3 commits into
mapillary:mainfrom
caglarpir:default-image-sources-with-video-source

Conversation

@caglarpir

Copy link
Copy Markdown
Contributor

Stacked on #864; review the last commit.

Problem

The README says --video_geotag_source applies to videos and --geotag_source to images. But the default sources were used only when neither option was given, so with --video_geotag_source alone, images had no source and were left out of the description file without a word. That includes the frames video_process samples:

mapillary_tools video_process 20190902_132329_NF.mp4 out --video_sample_distance 5 --video_geotag_source native
# samples 50 frames, writes [] and exits 0

Fix

With only --video_geotag_source, images are geotagged by the default sources (native, then exiftool_runtime), as when neither option is given. Videos are still geotagged by --video_geotag_source alone. The README says so.

Verification

  • The command above gives 50 geotagged frames, identical to the run without the option. A folder with a GoPro JPG and three videos now reports the JPG.
  • Sony FDR-X3000 with --video_geotag_source gpx: 1063 frames, identical in position and time to --geotag_source gpx.
  • New unit tests and an integration test. Unit and integration tests, doctests, mypy --python-version 3.9, ruff check, ruff format --check and usort diff are clean.

A misspelled source type, as in --geotag_source foo or gpx,foo, failed
with a ValueError traceback ("'foo' is not a valid SourceType"), and a
JSON source with a key the schema does not know, such as

    {"source": "gpx", "path": "track.gpx"}

failed with a jsonschema ValidationError traceback. Both exited 1, as for
a crash.

They now raise MapillaryBadParameterError (exit code 2), naming the
supported source types and their aliases, or what the schema rejected
("'path' was unexpected"). This covers --geotag_source and
--video_geotag_source in process and video_process, which parse them the
same way.
…r image

A truncated GPX file, or a file that is no GPX at all, given as the GPX
to geotag images from failed the whole run with a RuntimeError traceback
("Error parsing GPX ...: GPXXMLSyntaxException"). A video geotagged from
the same file gets a MapillaryInvalidGPXError in its description. A GPX
path that does not exist failed with a RuntimeError too, and a GPX file
with no timestamped point with an AssertionError. An NMEA file failed
with a traceback in each of these cases, and when a sentence had no time
or date (TypeError), such as the void ones a receiver writes before its
first fix, or when the file had no RMC sentence to give the date
(UnboundLocalError).

Every image now gets a MapillaryInvalidGPXError in the description,
saying what is wrong with the file, and the run exits as for any other
file that fails to process. The file was given to geotag the images
from, so a mistyped path fails them, as it did, rather than leaving
them to the next geotag source without a word.
…is given

The README says that --video_geotag_source applies to videos and
--geotag_source to images. But the default sources were used only when
neither option was given, so with --video_geotag_source alone, images
had no source at all, and went missing from the description file
without a word, as if they had not been there. That includes the frames
video_process samples: `video_process VIDEO --video_geotag_source native`
sampled the frames, then wrote an empty description file and exited 0.

Geotag images by the default sources when only --video_geotag_source is
given, as when neither option is. The videos are still geotagged by
--video_geotag_source alone.
@meta-cla meta-cla Bot added the cla signed label Oct 22, 2026
@caglarpir
caglarpir merged commit 099f138 into mapillary:main Oct 22, 2026
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant