fix(geocoding-maptiler): request POI types so stations and POIs surface

MapTiler omits POIs from its default geocoding response, so "Köln Hbf" returned only addresses (Hauptbahnhof Düren, Am Hauptbahnhof Bonn, …) and never Köln Hauptbahnhof. proximity/country/language/fuzzyMatch made no difference — only an explicit `types` whitelist that includes `poi` does. With it, MapTiler returns "Köln Hauptbahnhof" at relevance 1.0 as the top hit while still returning addresses, places and admin areas.

Send a fixed `types` whitelist (poi + address + admin levels) on geocode and autocomplete. Also document the (previously undocumented) INTEGRATION_GEOCODING_PROVIDER fallback chain in .env.example.

Author: Medformatik

apps/api/src/services/__tests__/maptiler-geocoding.test.ts

@@ -139,6 +139,32 @@ describe("geocode", () => {
   });
 });
 
+// request params
+
+describe("request includes POI types", () => {
+  it("geocode requests `types` including poi so station/POIs surface", async () => {
+    mockFetch.mockResolvedValueOnce(mockOk(makeMaptilerResponse([])));
+    const { maptilerGeocodingService } = await loadModule();
+
+    await maptilerGeocodingService.geocode("Köln Hbf");
+
+    // MapTiler omits POIs from its default response, so "Köln Hbf" returns only
+    // addresses (Düren Hbf, …) unless we explicitly ask for poi.
+    const types = new URL(String(mockFetch.mock.calls[0][0])).searchParams.get("types");
+    expect(types?.split(",")).toContain("poi");
+  });
+
+  it("autocomplete requests `types` including poi", async () => {
+    mockFetch.mockResolvedValueOnce(mockOk(makeMaptilerResponse([])));
+    const { maptilerGeocodingService } = await loadModule();
+
+    await maptilerGeocodingService.autocomplete("Köln Hb");
+
+    const types = new URL(String(mockFetch.mock.calls[0][0])).searchParams.get("types");
+    expect(types?.split(",")).toContain("poi");
+  });
+});
+
 // autocomplete
 
 describe("autocomplete", () => {

infra/docker/.env.example

@@ -216,6 +216,14 @@ MAPILLARY_TOKEN=
 #   - MOTIS Transitous config generation during `pnpm openmapx services build motis`
 # TRANSITOUS_COUNTRIES=de,at,ch
 #
+# Geocoding provider order — comma-separated fallback chain, tried left to
+# right (on error OR zero results, the next provider is used). Valid names:
+# maptiler, photon, nominatim, pelias, motis, transitous, entur, db-ris.
+# Defaults to `maptiler`. `photon,maptiler` queries the self-hosted Photon
+# first (strong on OSM POIs / stations) and falls back to MapTiler for global
+# coverage Photon's regional extract doesn't include.
+# INTEGRATION_GEOCODING_PROVIDER=photon,maptiler
+
 # Photon runtime download region.
 PHOTON_REGION=planet
 

integrations/geocoding-maptiler/provider.ts

@@ -15,6 +15,15 @@ import { resolvePoiIconPath } from "@openmapx/core";
 
 const BASE_URL = "https://api.maptiler.com/geocoding";
 
+// MapTiler omits POIs from its default geocoding response, so a query like
+// "Köln Hbf" returns only addresses (Düren Hbf, …) and never the station POI.
+// Requesting an explicit `types` whitelist that includes `poi` surfaces it
+// ("Köln Hauptbahnhof" at relevance 1.0) while keeping addresses, places, and
+// admin areas. Every name here is a valid MapTiler feature type — an unknown
+// one makes the API return 400.
+const SEARCH_TYPES =
+  "poi,address,street,neighbourhood,municipality,municipal_district,locality,subregion,region,county,country,postal_code,place";
+
 // Populated by setup(ctx) from the resolved integration config cascade.
 let apiKey: string | undefined;
 export function setMaptilerApiKey(value: string | undefined): void {
@@ -97,7 +106,7 @@ async function fetchMaptilerReverse(
 
 export const maptilerGeocodingService: GeocodingProviderImpl = {
   async geocode(query: string, lang?: string, proximity?: LngLat): Promise<SearchResult[]> {
-    const params: Record<string, string> = { limit: "10" };
+    const params: Record<string, string> = { limit: "10", types: SEARCH_TYPES };
     if (proximity) params.proximity = `${proximity[0]},${proximity[1]}`;
     const data = await fetchMaptiler(query, params, lang);
     return data.features.map((f) => ({
@@ -128,7 +137,11 @@ export const maptilerGeocodingService: GeocodingProviderImpl = {
   },
 
   async autocomplete(query: string, lang?: string): Promise<AutocompleteResult[]> {
-    const data = await fetchMaptiler(query, { limit: "6", autocomplete: "true" }, lang);
+    const data = await fetchMaptiler(
+      query,
+      { limit: "6", autocomplete: "true", types: SEARCH_TYPES },
+      lang,
+    );
     return data.features.map((f) => {
       const category = f.properties?.categories?.[0];
       return {