import {z} from 'zod' export type GetApiGeolocSearchArgs = {lat: number, lng: number, radius?: number | undefined, distance?: boolean | undefined, placetype?: string | undefined, format?: ('XML' | 'JSON' | 'PHP' | 'RUBY' | 'PYTHON' | 'YAML') | undefined, from?: number | undefined, to?: number | undefined, callback?: string | undefined, indent?: boolean | undefined}; export type GetApiGeolocSearchOptions = {baseUrl?: string | undefined, apiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const gisFeatureDistance = z.object({distance: z.number().optional(), name: z.string().optional(), adm1Code: z.string().optional(), adm2Code: z.string().optional(), adm3Code: z.string().optional(), adm4Code: z.string().optional(), adm5Code: z.string().optional(), adm1Name: z.string().optional(), adm2Name: z.string().optional(), adm3Name: z.string().optional(), adm4Name: z.string().optional(), adm5Name: z.string().optional(), asciiName: z.string().optional(), countryCode: z.string().optional(), elevation: z.number().int().optional(), featureClass: z.string().optional(), featureCode: z.string().optional(), featureId: z.number().int().optional(), gtopo30: z.number().int().optional(), population: z.number().int().optional(), timezone: z.string().optional(), lat: z.number().optional(), lng: z.number().optional(), placeType: z.string().optional(), oneWay: z.boolean().optional(), streetType: z.string().optional(), openstreetmapId: z.number().int().optional(), length: z.number().optional(), zipCodes: z.array(z.string()).optional(), google_map_url: z.string().optional(), yahoo_map_url: z.string().optional(), openstreetmap_map_url: z.string().optional(), country_flag_url: z.string().optional(), level: z.number().int().optional(), area: z.number().optional(), tld: z.string().optional(), capitalName: z.string().optional(), continent: z.string().optional(), postalCodeRegex: z.string().optional(), currencyCode: z.string().optional(), currencyName: z.string().optional(), equivalentFipsCode: z.string().optional(), fipsCode: z.string().optional(), iso3166Alpha2Code: z.string().optional(), iso3166Alpha3Code: z.string().optional(), iso3166NumericCode: z.string().optional(), phonePrefix: z.string().optional(), postalCodeMask: z.string().optional(), isIn: z.string().optional(), isInPlace: z.string().optional(), isInAdm: z.string().optional(), isInZip: z.string().optional(), amenity: z.string().optional(), fullyQualifiedAddress: z.string().optional()}); export const geolocResultsDto = z.object({numFound: z.number().int().optional(), QTime: z.number().int().optional(), result: z.array(gisFeatureDistance).optional(), error: z.string().optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Geocode an address * * GET /geoloc/search */ export const getApiGeolocSearch = async (args: GetApiGeolocSearchArgs, options?: GetApiGeolocSearchOptions) => { const {baseUrl = "http://free.gisgraphy.com", fetch: fetchFn = fetch, apiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.lat != null) query.append("lat", String(args.lat)) if (args.lng != null) query.append("lng", String(args.lng)) if (args.radius != null) query.append("radius", String(args.radius)) if (args.distance != null) query.append("distance", String(args.distance)) if (args.placetype != null) query.append("placetype", String(args.placetype)) if (args.format != null) query.append("format", String(args.format)) if (args.from != null) query.append("from", String(args.from)) if (args.to != null) query.append("to", String(args.to)) if (args.callback != null) query.append("callback", String(args.callback)) if (args.indent != null) query.append("indent", String(args.indent)) if (apiKey !== undefined) query.set("api_key", apiKey) const url = `${baseUrl.replace(/\/+$/, '')}/geoloc/search${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(geolocResultsDto, await res.json()) };