feat(overture): link the Overture Maps reference to the GERS explorer

The place card credited Overture by showing the GERS id under "Overture Maps"
but without a link. Make it clickable: the gers id-scheme view now builds an
explore.overturemaps.org deep link — ?feature=places.place.<gers>#16/<lat>/<lng>.
buildUrl gains an optional context carrying the place coordinates (place-ids),
and buildExternalRefs threads place.coordinates through. Degrades to the bare
?feature= link when coordinates are absent.

Author: Medformatik

apps/web/src/components/panels/place/PlaceInfoTab.tsx

@@ -267,7 +267,7 @@ export function PlaceInfoTab({ place, isLoading }: Props) {
   const hasDescription = Boolean(infoDescription);
   const hasFacts = Boolean(place.facts?.length);
   const hasOsmTags = Boolean(place.osmTags && Object.keys(place.osmTags).length > 0);
-  const externalRefs = buildExternalRefs(place.ids);
+  const externalRefs = buildExternalRefs(place.ids, place.coordinates);
   const hasExternalRefs = externalRefs.length > 0;
   const hasAnyContent = hasDescription || hasFacts || hasOsmTags || hasExternalRefs;
 

apps/web/src/components/panels/place/externalIdLinks.ts

@@ -21,7 +21,10 @@ export interface ExternalRef {
  * schemes (transit providers, data-source item ids) are not cross-refs
  * and shouldn't be shown.
  */
-export function buildExternalRefs(ids: PlaceIds | undefined): ExternalRef[] {
+export function buildExternalRefs(
+  ids: PlaceIds | undefined,
+  coordinates?: [number, number],
+): ExternalRef[] {
   if (!ids) return [];
 
   type Entry = {
@@ -45,7 +48,7 @@ export function buildExternalRefs(ids: PlaceIds | undefined): ExternalRef[] {
       order: view.displayOrder ?? Number.POSITIVE_INFINITY,
       insertionIndex: insertionIndex++,
       label: view.label,
-      url: view.buildUrl?.(value),
+      url: view.buildUrl?.(value, { coordinates }),
     });
   }
 

packages/place-ids/src/builtin-views.ts

@@ -57,8 +57,15 @@ export function registerBuiltinIdSchemeViews(): void {
     scheme: "gers",
     label: "Overture Maps",
     displayOrder: 25,
-    // Overture's GERS ids have no canonical per-feature public page, so the id
-    // is shown as a source credit without a deep link (like EVA/GTFS).
+    buildUrl(value, context) {
+      // Overture's GERS explorer: ?feature=places.place.<gers>#<zoom>/<lat>/<lng>.
+      const base = `https://explore.overturemaps.org/?feature=places.place.${encodeURIComponent(value)}`;
+      const c = context?.coordinates;
+      if (c && Number.isFinite(c[0]) && Number.isFinite(c[1])) {
+        return `${base}#16/${c[1]}/${c[0]}`;
+      }
+      return base;
+    },
   });
 
   // Transit / stations

packages/place-ids/src/external-platforms.test.ts

@@ -89,4 +89,18 @@ describe("external platform URL builders", () => {
     expect(view?.label).toBe("Overture Maps");
     expect(view?.internal).toBeFalsy();
   });
+
+  it("builds an Overture explorer deep link from the gers id + coordinates", () => {
+    registerBuiltinIdSchemeViews();
+    const view = getIdSchemeView("gers");
+    expect(
+      view?.buildUrl?.("aff9ee5d-3ec2-4ab0-af60-823b5244fb5f", { coordinates: [6.6867, 51.1734] }),
+    ).toBe(
+      "https://explore.overturemaps.org/?feature=places.place.aff9ee5d-3ec2-4ab0-af60-823b5244fb5f#16/51.1734/6.6867",
+    );
+    // Without coordinates it still links to the feature, omitting the viewport.
+    expect(view?.buildUrl?.("abc")).toBe(
+      "https://explore.overturemaps.org/?feature=places.place.abc",
+    );
+  });
 });

packages/place-ids/src/presentation.ts

@@ -8,6 +8,15 @@
  * order for anything without an explicit number.
  */
 
+/**
+ * Optional context passed to {@link IdSchemeView.buildUrl}, for schemes whose
+ * URL embeds the place's location (e.g. a map-explorer deep link).
+ */
+export interface IdSchemeUrlContext {
+  /** Place coordinates as `[lng, lat]`. */
+  coordinates?: [number, number];
+}
+
 export interface IdSchemeView {
   /** Scheme key in `Place.ids` (e.g. `"osm"`, `"yelp"`, `"ocm"`). */
   scheme: string;
@@ -24,9 +33,10 @@ export interface IdSchemeView {
   /**
    * Return an external URL for a given id value, or `undefined` if the
    * scheme isn't naturally linkable (e.g. a raw EVA number). Accepts the
-   * raw id value (without the `scheme:` prefix).
+   * raw id value (without the `scheme:` prefix) and optional place context
+   * (e.g. coordinates) for schemes whose URL embeds a map viewport.
    */
-  buildUrl?(value: string): string | undefined;
+  buildUrl?(value: string, context?: IdSchemeUrlContext): string | undefined;
 }
 
 const registry = new Map<string, IdSchemeView>();