경계 데이터 어댑터

1import bbox from "@turf/bbox";2import { z } from "zod";3import type {4  RegionFeature,5  RegionFeatureCollection,6  RegionKind,7  RegionTile,8  RegionTileManifest,9  RegionViewQuery,10} from "@/pages/editor/features/regions/api/regionsApi";11
12// 문서용 구현 예제입니다. 기본 에디터에는 자동 등록되지 않습니다.13// 내재화한 소스에서 기존 regionsApi.ts의 조회 함수를 이 구현에 위임하세요.14export type BoundaryDataAdapter = {15  fetchRegionKinds(country?: string, signal?: AbortSignal): Promise<RegionKind[]>;16  fetchRegionsByView(17    query: RegionViewQuery,18    signal?: AbortSignal,19  ): Promise<RegionFeatureCollection>;20  fetchRegionById(21    boundaryId: string | number,22    signal?: AbortSignal,23  ): Promise<RegionFeature>;24  fetchRegionByCode(25    kind: string,26    code: string,27    country?: string,28    signal?: AbortSignal,29  ): Promise<RegionFeature>;30  fetchRegionTileManifest(signal?: AbortSignal): Promise<RegionTileManifest | null>;31  fetchRegionsByTile(32    tile: RegionTile,33    manifest: RegionTileManifest,34    zoom: number,35    kind: string,36    signal?: AbortSignal,37  ): Promise<RegionFeatureCollection>;38};39
40const coordinate = z.tuple([41  z.number().min(-180).max(180),42  z.number().min(-90).max(90),43]);44const ring = z45  .array(coordinate)46  .min(4)47  .refine((points) => {48    const first = points[0];49    const last = points[points.length - 1];50    if (!first || !last) return false;51    return (52      first[0] === last[0] &&53      first[1] === last[1] &&54      new Set(points.map((point) => point.join(","))).size >= 355    );56  }, "링을 닫고 서로 다른 정점을 3개 이상 넣어주세요.");57const polygon = z.array(ring).min(1);58const geometry = z.discriminatedUnion("type", [59  z.object({ type: z.literal("Polygon"), coordinates: polygon }),60  z.object({ type: z.literal("MultiPolygon"), coordinates: z.array(polygon).min(1) }),61]);62const bundleSchema = z63  .object({64    country: z.string().length(2),65    kinds: z.array(66      z.object({67        kind: z.string().min(1),68        label: z.string().min(1),69        level: z.number().int(),70        min_zoom: z.number().finite(),71        sort_order: z.number().int(),72        selectable: z.boolean(),73      }),74    ),75    features: z.array(76      z.object({77        type: z.literal("Feature"),78        id: z.string().min(1),79        geometry,80        properties: z81          .object({ kind: z.string().min(1), code: z.string(), name: z.string() })82          .passthrough(),83      }),84    ),85  })86  .superRefine((bundle, context) => {87    const kinds = new Set(bundle.kinds.map((kind) => kind.kind));88    const ids = new Set(bundle.features.map((feature) => feature.id));89    if (kinds.size !== bundle.kinds.length || ids.size !== bundle.features.length) {90      context.addIssue({91        code: "custom",92        message: "kind와 Feature.id는 중복될 수 없습니다.",93      });94    }95    if (bundle.features.some((feature) => !kinds.has(feature.properties.kind))) {96      context.addIssue({97        code: "custom",98        message: "모든 도형의 kind를 카탈로그에 등록하세요.",99      });100    }101  });102
103// 작은 공개 데이터셋용입니다. 전국 데이터는 bbox를 처리하는 자체 API로 분리하세요.104export function createJsonBoundaryAdapter(url: string): BoundaryDataAdapter {105  async function read(signal?: AbortSignal) {106    signal?.throwIfAborted();107    const response = await fetch(url, { signal });108    if (!response.ok) throw new Error(`경계 JSON 요청 실패: ${response.status}`);109    const payload: unknown = await response.json();110    signal?.throwIfAborted();111    return bundleSchema.parse(payload);112  }113
114  return {115    async fetchRegionKinds(country = "KR", signal) {116      const bundle = await read(signal);117      return country === bundle.country118        ? [...bundle.kinds].sort((a, b) => a.sort_order - b.sort_order)119        : [];120    },121    async fetchRegionsByView(query, signal) {122      const bundle = await read(signal);123      const country = query.country ?? "KR";124      const kind = bundle.kinds.find((item) => item.kind === query.kind);125      const features =126        country === bundle.country && kind && query.zoom >= kind.min_zoom127          ? bundle.features.filter((feature) => {128              if (feature.properties.kind !== query.kind) return false;129              const [west, south, east, north] = bbox(feature);130              return (131                west <= query.maxLng &&132                east >= query.minLng &&133                south <= query.maxLat &&134                north >= query.minLat135              );136            })137          : [];138      // 화면 bbox와 겹치는 도형을 전체 좌표로 반환합니다. geometry를 화면에 맞춰 자르지 않습니다.139      return {140        type: "FeatureCollection",141        country,142        kind: query.kind,143        level: kind?.level ?? null,144        truncated: false,145        features,146      };147    },148    async fetchRegionById(boundaryId, signal) {149      const bundle = await read(signal);150      return (151        bundle.features.find((feature) => feature.id === String(boundaryId)) ?? null152      );153    },154    async fetchRegionByCode(kind, code, country = "KR", signal) {155      const bundle = await read(signal);156      return country === bundle.country157        ? (bundle.features.find(158            (feature) =>159              feature.properties.kind === kind && feature.properties.code === code,160          ) ?? null)161        : null;162    },163    async fetchRegionTileManifest(signal) {164      signal?.throwIfAborted();165      // 기존 hook은 null을 받으면 낮은 줌에서도 byView 경로를 사용합니다.166      return null;167    },168    async fetchRegionsByTile() {169      throw new Error("이 JSON 어댑터는 타일 조회 대신 byView를 사용합니다.");170    },171  };172}