fetch Metadata
Loads this raster product's frame times and registers them as the source's valid times.
Until this existed an image raster had no valid times at all, so the tile pyramid fell back to a single frame from twelve hours ago (see TilePyramid.ensureStaticRasterLayerTimeline) and held it for the whole animation: satellite never moved with the timeline, in any app.
The Raster Maps metadata endpoint (/{accessKey}/{code}.json) lists every available frame as files[].timestamp, in seconds. Frames inside the timeline range (padded an hour either side, so the first and last slots have a frame to snap to) become the source's timeDates; the timeline maps its own slots onto them per layer, as it does for encoded sources, which keeps the frame count bounded however frequent the product's frames are.
A failed fetch is not an error for the layer: it keeps the single-frame fallback, and the next attempt waits METADATA_RETRY_MS.