feat(web): add geolocation utility (#20758)

* feat(geolocation):  add geolocation utility

* feat(web): geolocation utility - fix code review - 1

* feat(web): geolocation utility - fix code review - 2

* chore: cleanup

* chore: feedback

* feat(web): add animation and text

animation on locations change and action text on thumbnail

* styling, messages and filtering

* selected color

* format i18n

* fix lint

---------

Co-authored-by: Jason Rasmussen <jason@rasm.me>
Co-authored-by: Alex <alex.tran1502@gmail.com>

web/src/lib/components/asset-viewer/detail-panel-location.svelte

@@ -16,18 +16,22 @@
 
   let isShowChangeLocation = $state(false);
 
-  async function handleConfirmChangeLocation(gps: { lng: number; lat: number }) {
+  const onClose = async (point?: { lng: number; lat: number }) => {
     isShowChangeLocation = false;
 
+    if (!point) {
+      return;
+    }
+
     try {
       asset = await updateAsset({
         id: asset.id,
-        updateAssetDto: { latitude: gps.lat, longitude: gps.lng },
+        updateAssetDto: { latitude: point.lat, longitude: point.lng },
       });
     } catch (error) {
       handleError(error, $t('errors.unable_to_change_location'));
     }
-  }
+  };
 </script>
 
 {#if asset.exifInfo?.country}
@@ -85,6 +89,6 @@
 
 {#if isShowChangeLocation}
   <Portal>
-    <ChangeLocation {asset} onConfirm={handleConfirmChangeLocation} onCancel={() => (isShowChangeLocation = false)} />
+    <ChangeLocation {asset} {onClose} />
   </Portal>
 {/if}

web/src/lib/components/assets/thumbnail/thumbnail.svelte

@@ -197,7 +197,7 @@
 <div
   class={[
     'focus-visible:outline-none flex overflow-hidden',
-    disabled ? 'bg-gray-300' : 'bg-immich-primary/20 dark:bg-immich-dark-primary/20',
+    disabled ? 'bg-gray-300' : 'bg-primary/30 dark:bg-primary/70',
   ]}
   style:width="{width}px"
   style:height="{height}px"

web/src/lib/components/photos-page/actions/change-location-action.svelte

@@ -4,10 +4,10 @@
   import { getSelectedAssets } from '$lib/utils/asset-utils';
   import { handleError } from '$lib/utils/handle-error';
   import { updateAssets } from '@immich/sdk';
-  import MenuOption from '../../shared-components/context-menu/menu-option.svelte';
-  import { getAssetControlContext } from '../asset-select-control-bar.svelte';
   import { mdiMapMarkerMultipleOutline } from '@mdi/js';
   import { t } from 'svelte-i18n';
+  import MenuOption from '../../shared-components/context-menu/menu-option.svelte';
+  import { getAssetControlContext } from '../asset-select-control-bar.svelte';
 
   interface Props {
     menuItem?: boolean;
@@ -18,16 +18,21 @@
 
   let isShowChangeLocation = $state(false);
 
-  async function handleConfirm(point: { lng: number; lat: number }) {
+  async function handleConfirm(point?: { lng: number; lat: number }) {
     isShowChangeLocation = false;
+
+    if (!point) {
+      return;
+    }
+
     const ids = getSelectedAssets(getOwnedAssets(), $user);
 
     try {
       await updateAssets({ assetBulkUpdateDto: { ids, latitude: point.lat, longitude: point.lng } });
+      clearSelect();
     } catch (error) {
       handleError(error, $t('errors.unable_to_update_location'));
     }
-    clearSelect();
   }
 </script>
 
@@ -39,5 +44,5 @@
   />
 {/if}
 {#if isShowChangeLocation}
-  <ChangeLocation onConfirm={handleConfirm} onCancel={() => (isShowChangeLocation = false)} />
+  <ChangeLocation onClose={handleConfirm} />
 {/if}

web/src/lib/components/shared-components/change-location.svelte

@@ -21,11 +21,11 @@
 
   interface Props {
     asset?: AssetResponseDto | undefined;
-    onCancel: () => void;
-    onConfirm: (point: Point) => void;
+    point?: Point;
+    onClose: (point?: Point) => void;
   }
 
-  let { asset = undefined, onCancel, onConfirm }: Props = $props();
+  let { asset = undefined, point: initialPoint, onClose }: Props = $props();
 
   let places: PlacesResponseDto[] = $state([]);
   let suggestedPlaces: PlacesResponseDto[] = $state([]);
@@ -38,14 +38,20 @@
 
   let previousLocation = get(lastChosenLocation);
 
-  let assetLat = $derived(asset?.exifInfo?.latitude ?? undefined);
-  let assetLng = $derived(asset?.exifInfo?.longitude ?? undefined);
+  let assetLat = $derived(initialPoint?.lat ?? asset?.exifInfo?.latitude ?? undefined);
+  let assetLng = $derived(initialPoint?.lng ?? asset?.exifInfo?.longitude ?? undefined);
 
   let mapLat = $derived(assetLat ?? previousLocation?.lat ?? undefined);
   let mapLng = $derived(assetLng ?? previousLocation?.lng ?? undefined);
 
   let zoom = $derived(mapLat !== undefined && mapLng !== undefined ? 12.5 : 1);
 
+  $effect(() => {
+    if (mapElement && initialPoint) {
+      mapElement.addClipMapMarker(initialPoint.lng, initialPoint.lat);
+    }
+  });
+
   $effect(() => {
     if (places) {
       suggestedPlaces = places.slice(0, 5);
@@ -55,14 +61,14 @@
     }
   });
 
-  let point: Point | null = $state(null);
+  let point: Point | null = $state(initialPoint ?? null);
 
-  const handleConfirm = () => {
-    if (point) {
+  const handleConfirm = (confirmed?: boolean) => {
+    if (point && confirmed) {
       lastChosenLocation.set(point);
-      onConfirm(point);
+      onClose(point);
     } else {
-      onCancel();
+      onClose();
     }
   };
 
@@ -109,6 +115,11 @@
     point = { lng: longitude, lat: latitude };
     mapElement?.addClipMapMarker(longitude, latitude);
   };
+
+  const onUpdate = (lat: number, lng: number) => {
+    point = { lat, lng };
+    mapElement?.addClipMapMarker(lng, lat);
+  };
 </script>
 
 <ConfirmModal
@@ -116,7 +127,7 @@
   title={$t('change_location')}
   icon={mdiMapMarkerMultipleOutline}
   size="medium"
-  onClose={(confirmed) => (confirmed ? handleConfirm() : onCancel())}
+  onClose={handleConfirm}
 >
   {#snippet promptSnippet()}
     <div class="flex flex-col w-full h-full gap-2">
@@ -197,14 +208,7 @@
       </div>
 
       <div class="grid sm:grid-cols-2 gap-4 text-sm text-start mt-4">
-        <CoordinatesInput
-          lat={point ? point.lat : assetLat}
-          lng={point ? point.lng : assetLng}
-          onUpdate={(lat, lng) => {
-            point = { lat, lng };
-            mapElement?.addClipMapMarker(lng, lat);
-          }}
-        />
+        <CoordinatesInput lat={point ? point.lat : assetLat} lng={point ? point.lng : assetLng} {onUpdate} />
       </div>
     </div>
   {/snippet}

web/src/lib/components/shared-components/date-picker.svelte

@@ -0,0 +1,113 @@
+<script lang="ts">
+  import { Button } from '@immich/ui';
+  import { t } from 'svelte-i18n';
+
+  interface Props {
+    onDateChange: (year?: number, month?: number, day?: number) => Promise<void>;
+    onClearFilters?: () => void;
+    defaultDate?: string;
+  }
+
+  let { onDateChange, onClearFilters, defaultDate }: Props = $props();
+
+  let selectedYear = $state<number | undefined>(undefined);
+  let selectedMonth = $state<number | undefined>(undefined);
+  let selectedDay = $state<number | undefined>(undefined);
+
+  const currentYear = new Date().getFullYear();
+  const yearOptions = Array.from({ length: 30 }, (_, i) => currentYear - i);
+
+  const monthOptions = Array.from({ length: 12 }, (_, i) => ({
+    value: i + 1,
+    label: new Date(2000, i).toLocaleString('default', { month: 'long' }),
+  }));
+
+  const dayOptions = $derived.by(() => {
+    if (!selectedYear || !selectedMonth) {
+      return [];
+    }
+    const daysInMonth = new Date(selectedYear, selectedMonth, 0).getDate();
+    return Array.from({ length: daysInMonth }, (_, i) => i + 1);
+  });
+
+  if (defaultDate) {
+    const [year, month, day] = defaultDate.split('-');
+    selectedYear = Number.parseInt(year);
+    selectedMonth = Number.parseInt(month);
+    selectedDay = Number.parseInt(day);
+  }
+
+  const filterAssetsByDate = async () => {
+    await onDateChange(selectedYear, selectedMonth, selectedDay);
+  };
+
+  const clearFilters = () => {
+    selectedYear = undefined;
+    selectedMonth = undefined;
+    selectedDay = undefined;
+    if (onClearFilters) {
+      onClearFilters();
+    }
+  };
+</script>
+
+<div class="mt-2 mb-2 p-2 rounded-lg">
+  <div class="flex flex-wrap gap-4 items-end w-136">
+    <div class="flex-1 min-w-20">
+      <label for="year-select" class="immich-form-label">
+        {$t('year')}
+      </label>
+      <select
+        id="year-select"
+        bind:value={selectedYear}
+        onchange={filterAssetsByDate}
+        class="text-sm w-full mt-1 px-3 py-1 border border-gray-300 dark:border-gray-600 rounded-lg focus:outline-none focus:ring-1 focus:ring-primary focus:border-primary bg-white dark:bg-gray-700 text-gray-900 dark:text-white"
+      >
+        <option value={undefined}>{$t('year')}</option>
+        {#each yearOptions as year (year)}
+          <option value={year}>{year}</option>
+        {/each}
+      </select>
+    </div>
+
+    <div class="flex-2 min-w-24">
+      <label for="month-select" class="immich-form-label">
+        {$t('month')}
+      </label>
+      <select
+        id="month-select"
+        bind:value={selectedMonth}
+        onchange={filterAssetsByDate}
+        disabled={!selectedYear}
+        class="text-sm w-full mt-1 px-3 py-1 border border-gray-300 dark:border-gray-600 rounded-lg focus:outline-none focus:ring-1 focus:ring-primary focus:border-primary bg-white dark:bg-gray-700 text-gray-900 dark:text-white disabled:opacity-50 disabled:bg-gray-400"
+      >
+        <option value={undefined}>{$t('month')}</option>
+        {#each monthOptions as month (month.value)}
+          <option value={month.value}>{month.label}</option>
+        {/each}
+      </select>
+    </div>
+
+    <div class="flex-1 min-w-16">
+      <label for="day-select" class="immich-form-label">
+        {$t('day')}
+      </label>
+      <select
+        id="day-select"
+        bind:value={selectedDay}
+        onchange={filterAssetsByDate}
+        disabled={!selectedYear || !selectedMonth}
+        class="text-sm w-full mt-1 px-3 py-1 border border-gray-300 dark:border-gray-600 rounded-lg focus:outline-none focus:ring-1 focus:ring-primary focus:border-primary bg-white dark:bg-gray-700 text-gray-900 dark:text-white disabled:opacity-50 disabled:bg-gray-400"
+      >
+        <option value={undefined}>{$t('day')}</option>
+        {#each dayOptions as day (day)}
+          <option value={day}>{day}</option>
+        {/each}
+      </select>
+    </div>
+
+    <div class="flex">
+      <Button size="small" color="secondary" variant="ghost" onclick={clearFilters}>{$t('reset')}</Button>
+    </div>
+  </div>
+</div>

web/src/lib/components/utilities-page/geolocation/geolocation.svelte

@@ -0,0 +1,104 @@
+<script lang="ts">
+  import Thumbnail from '$lib/components/assets/thumbnail/thumbnail.svelte';
+  import { AppRoute } from '$lib/constants';
+  import type { AssetInteraction } from '$lib/stores/asset-interaction.svelte';
+  import { toTimelineAsset } from '$lib/utils/timeline-util';
+  import { type AssetResponseDto } from '@immich/sdk';
+  import { t } from 'svelte-i18n';
+
+  interface Props {
+    asset: AssetResponseDto;
+    assetInteraction: AssetInteraction;
+    onSelectAsset: (asset: AssetResponseDto) => void;
+    onMouseEvent: (asset: AssetResponseDto) => void;
+    onLocation: (location: { latitude: number; longitude: number }) => void;
+  }
+
+  let { asset, assetInteraction, onSelectAsset, onMouseEvent, onLocation }: Props = $props();
+
+  let assetData = $derived(
+    JSON.stringify(
+      {
+        originalFileName: asset.originalFileName,
+        localDateTime: asset.localDateTime,
+        make: asset.exifInfo?.make,
+        model: asset.exifInfo?.model,
+        gps: {
+          latitude: asset.exifInfo?.latitude,
+          longitude: asset.exifInfo?.longitude,
+        },
+        location: asset.exifInfo?.city ? `${asset.exifInfo?.country} - ${asset.exifInfo?.city}` : undefined,
+      },
+      null,
+      2,
+    ),
+  );
+  let boxWidth = $state(300);
+  let timelineAsset = $derived(toTimelineAsset(asset));
+  const hasGps = $derived(!!asset.exifInfo?.latitude && !!asset.exifInfo?.longitude);
+</script>
+
+<div
+  class="w-full aspect-square rounded-xl border-3 transition-colors font-semibold text-xs dark:bg-black bg-gray-200 border-gray-200 dark:border-gray-800"
+  bind:clientWidth={boxWidth}
+  title={assetData}
+>
+  <div class="relative w-full h-full overflow-hidden rounded-lg">
+    <Thumbnail
+      asset={timelineAsset}
+      onClick={() => {
+        if (asset.exifInfo?.latitude && asset.exifInfo?.longitude) {
+          onLocation({ latitude: asset.exifInfo?.latitude, longitude: asset.exifInfo?.longitude });
+        } else {
+          onSelectAsset(asset);
+        }
+      }}
+      onSelect={() => onSelectAsset(asset)}
+      onMouseEvent={() => onMouseEvent(asset)}
+      selected={assetInteraction.hasSelectedAsset(asset.id)}
+      selectionCandidate={assetInteraction.hasSelectionCandidate(asset.id)}
+      thumbnailSize={boxWidth}
+      readonly={hasGps}
+    />
+
+    {#if hasGps}
+      <div class="absolute bottom-1 end-3 px-4 py-1 rounded-xl text-xs transition-colors bg-success text-black">
+        {$t('gps')}
+      </div>
+    {:else}
+      <div class="absolute bottom-1 end-3 px-4 py-1 rounded-xl text-xs transition-colors bg-danger text-light">
+        {$t('gps_missing')}
+      </div>
+    {/if}
+  </div>
+  <div class="text-center mt-4 px-4 text-sm font-semibold truncate" title={asset.originalFileName}>
+    <a href={`${AppRoute.PHOTOS}/${asset.id}`} target="_blank" rel="noopener noreferrer">
+      {asset.originalFileName}
+    </a>
+  </div>
+  <div class="text-center my-3">
+    <p class="px-4 text-xs font-normal truncate text-dark/75">
+      {new Date(asset.localDateTime).toLocaleDateString(undefined, {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+      })}
+    </p>
+    <p class="px-4 text-xs font-normal truncate text-dark/75">
+      {new Date(asset.localDateTime).toLocaleTimeString(undefined, {
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        timeZone: 'UTC',
+      })}
+    </p>
+    {#if hasGps}
+      <p class="text-primary mt-2 text-xs font-normal px-4 text-center truncate">
+        {asset.exifInfo?.country}
+      </p>
+      <p class="text-primary text-xs font-normal px-4 text-center truncate">
+        {asset.exifInfo?.city}
+      </p>
+    {/if}
+  </div>
+</div>

web/src/lib/components/utilities-page/utilities-menu.svelte

@@ -1,29 +1,23 @@
 <script lang="ts">
   import Icon from '$lib/components/elements/icon.svelte';
   import { AppRoute } from '$lib/constants';
-  import { mdiContentDuplicate, mdiImageSizeSelectLarge } from '@mdi/js';
+  import { mdiContentDuplicate, mdiCrosshairsGps, mdiImageSizeSelectLarge } from '@mdi/js';
   import { t } from 'svelte-i18n';
+
+  const links = [
+    { href: AppRoute.DUPLICATES, icon: mdiContentDuplicate, label: $t('review_duplicates') },
+    { href: AppRoute.LARGE_FILES, icon: mdiImageSizeSelectLarge, label: $t('review_large_files') },
+    { href: AppRoute.GEOLOCATION, icon: mdiCrosshairsGps, label: $t('manage_geolocation') },
+  ];
 </script>
 
 <div class="border border-gray-300 dark:border-immich-dark-gray rounded-3xl pt-1 pb-6 dark:text-white">
   <p class="text-xs font-medium p-4">{$t('organize_your_library').toUpperCase()}</p>
 
-  <a
-    href={AppRoute.DUPLICATES}
-    class="w-full hover:bg-gray-100 dark:hover:bg-immich-dark-gray flex items-center gap-4 p-4"
-  >
-    <span
-      ><Icon path={mdiContentDuplicate} class="text-immich-primary dark:text-immich-dark-primary" size="24" />
-    </span>
-    {$t('review_duplicates')}
-  </a>
-  <a
-    href={AppRoute.LARGE_FILES}
-    class="w-full hover:bg-gray-100 dark:hover:bg-immich-dark-gray flex items-center gap-4 p-4"
-  >
-    <span
-      ><Icon path={mdiImageSizeSelectLarge} class="text-immich-primary dark:text-immich-dark-primary" size="24" />
-    </span>
-    {$t('review_large_files')}
-  </a>
+  {#each links as link (link.href)}
+    <a href={link.href} class="w-full hover:bg-gray-100 dark:hover:bg-immich-dark-gray flex items-center gap-4 p-4">
+      <span><Icon path={link.icon} class="text-immich-primary dark:text-immich-dark-primary" size="24" /> </span>
+      {link.label}
+    </a>
+  {/each}
 </div>