feat(geocoding): implement address search and reverse geocoding APIs

server/api/geocoding/reverse.get.ts

@@ -0,0 +1,19 @@
+import { createError, getQuery } from 'h3'
+import { reverseGeocode } from '../../utils/geocoding'
+
+export default defineEventHandler(async (event) => {
+  const query = getQuery(event)
+  const latitude = typeof query.lat === 'string' ? Number.parseFloat(query.lat) : Number.NaN
+  const longitude = typeof query.lng === 'string' ? Number.parseFloat(query.lng) : Number.NaN
+
+  if (!Number.isFinite(latitude) || !Number.isFinite(longitude)) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: 'Invalid coordinates'
+    })
+  }
+
+  const address = await reverseGeocode(latitude, longitude)
+
+  return { address }
+})

server/api/geocoding/search.get.ts

@@ -0,0 +1,20 @@
+import { createError, getQuery } from 'h3'
+import { searchAddresses } from '../../utils/geocoding'
+
+export default defineEventHandler(async (event) => {
+  const query = getQuery(event)
+  const rawText = typeof query.q === 'string' ? query.q.trim() : ''
+  const rawLimit = typeof query.limit === 'string' ? Number.parseInt(query.limit, 10) : 5
+  const limit = Number.isFinite(rawLimit) ? Math.min(Math.max(rawLimit, 1), 8) : 5
+
+  if (rawText.length < 3) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: 'Query too short'
+    })
+  }
+
+  const suggestions = await searchAddresses(rawText, limit)
+
+  return { suggestions }
+})