fix(overture): credit Overture on place cards via a GERS external reference

The place card showed OSM as a source but never Overture, even when Overture
supplied the phone/website/brand — because the resolved GERS id was used
internally and then dropped. Surface it: knowledge-overture now returns
externalIds.gers for every match, foldExternalIdsIntoPlace folds it into
place.ids.gers, and place-ids registers an "Overture Maps" id-scheme view —
so the Info tab's External references credits Overture exactly the way it
credits OSM. (Site-wide license attribution already lives in the legal tables
now that the integrations are enabled; this adds the per-place, data-flow
credit.)

Author: Medformatik

apps/api/src/routes/places.ts

@@ -73,6 +73,11 @@ function foldExternalIdsIntoPlace(
     if (externalIds.facebook && !ids.facebook && buildFacebookUrl(externalIds.facebook)) {
       ids.facebook = externalIds.facebook;
     }
+    // Overture GERS id — surfaces as an "Overture Maps" external reference,
+    // crediting the source whenever Overture enrichment matched the place.
+    if (externalIds.gers && !ids.gers) {
+      ids.gers = externalIds.gers;
+    }
   }
   const osmTripadvisor = place.osmTags?.["contact:tripadvisor"];
   if (osmTripadvisor && !ids.tripadvisor && buildTripadvisorUrl(osmTripadvisor)) {

integrations/knowledge-overture/__tests__/provider.test.ts

@@ -146,6 +146,8 @@ describe("knowledge-overture provider lookup", () => {
     expect(result?.names).toEqual({ de: "Starbucks", fr: "Starbucks" });
     expect(result?.structuredOpeningHours).toBe("Mo-Fr 07:00-21:00; Sa-Su 08:00-20:00");
     expect(result?.externalIds?.wikidata).toBe("Q37158");
+    // The GERS id is always exposed so the place card can credit Overture.
+    expect(result?.externalIds?.gers).toBe("overture-abc-123");
     expect(result?.phone).toBe("+49 30 1234567");
     expect(result?.website).toBe("https://starbucks.de");
   });

integrations/knowledge-overture/provider.ts

@@ -146,18 +146,17 @@ async function fetchOverturePlaceByGers(
 }
 
 function overtureRowToKnowledgeResult(row: OvertureDetailRow): KnowledgeResult | null {
-  const result: KnowledgeResult = {};
+  // A successful match always credits Overture as a source via its GERS id,
+  // which surfaces as an "Overture Maps" external reference on the place card.
+  const result: KnowledgeResult = { externalIds: { gers: row.gers_id } };
 
   const brandName = row.brand?.names?.primary;
   if (brandName) {
     result.brand = { name: brandName };
-    if (row.brand?.wikidata) {
-      result.brand.wikidata = row.brand.wikidata;
-      result.externalIds = { wikidata: row.brand.wikidata };
-    }
-  } else if (row.brand?.wikidata) {
-    // Branded place with no resolvable brand name — still expose the Q-id.
-    result.externalIds = { wikidata: row.brand.wikidata };
+  }
+  if (row.brand?.wikidata) {
+    if (result.brand) result.brand.wikidata = row.brand.wikidata;
+    result.externalIds = { ...result.externalIds, wikidata: row.brand.wikidata };
   }
 
   if (row.names && Object.keys(row.names).length > 0) {
@@ -174,7 +173,8 @@ function overtureRowToKnowledgeResult(row: OvertureDetailRow): KnowledgeResult |
   const website = row.websites?.[0];
   if (website) result.website = website;
 
-  return Object.keys(result).length > 0 ? result : null;
+  // Always non-empty: externalIds.gers is set for every match.
+  return result;
 }
 
 export const overtureKnowledgeSource: KnowledgeProvider = {

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

@@ -53,6 +53,14 @@ export function registerBuiltinIdSchemeViews(): void {
     },
   });
 
+  registerIdSchemeView({
+    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).
+  });
+
   // Transit / stations
 
   registerIdSchemeView({

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

@@ -82,4 +82,11 @@ describe("external platform URL builders", () => {
       "https://www.instagram.com/openmapx/",
     );
   });
+
+  it("registers a user-facing 'Overture Maps' view for the gers scheme", () => {
+    registerBuiltinIdSchemeViews();
+    const view = getIdSchemeView("gers");
+    expect(view?.label).toBe("Overture Maps");
+    expect(view?.internal).toBeFalsy();
+  });
 });