import { type DiscoverPlacesResponse, type GeocodingResponse, type ReverseGeocodingResponse, type POICategoriesResponse, type Circle } from "@tomtom-org/maps-sdk/services";
import type { Polygon, Position } from "geojson";
import { type Places, type Routes } from "@tomtom-org/maps-sdk/core";
import type * as SearchSchema from "../../schemas/search/searchSchema";
export type FuzzySearchOptions = Pick<SearchSchema.FuzzySearchParams, "limit" | "countries" | "position" | "radius" | "boundingBox" | "typeahead" | "minFuzzyLevel" | "maxFuzzyLevel" | "entityTypeSet" | "idxSet" | PlacesFieldKey | SearchExtraFieldKey | PoiFilterKey>;
export type PoiSearchOptions = Pick<SearchSchema.PoiSearchParams, "limit" | "countries" | "position" | "radius" | "boundingBox" | "typeahead" | PlacesFieldKey | SearchExtraFieldKey | PoiFilterKey>;
export type GeocodeOptions = Pick<SearchSchema.GeocodeSearchParams, "limit" | "countries" | "position" | "boundingBox" | "radius" | "mapcodes" | "extendedPostalCodesFor" | "entityTypeSet" | PlacesFieldKey>;
export type ReverseGeocodeOptions = Pick<SearchSchema.ReverseGeocodeSearchParams, "language" | "view" | "radius" | "heading" | "entityType">;
export type NearbySearchOptions = Pick<SearchSchema.NearbySearchParams, "radius" | "limit" | "countries" | PlacesFieldKey | SearchExtraFieldKey | PoiFilterKey>;
/** The paged searches' fields: language, geopolitical view and the page to continue. */
type PlacesFieldKey = "language" | "view" | "cursor";
/** Optional result fields fuzzy, POI and nearby search can add (tool parameters of the same name). */
type SearchExtraFieldKey = "mapcodes" | "extendedPostalCodesFor" | "openingHours" | "timeZone" | "relatedPois";
/** POI filters every places search but geocoding takes; the API applies them to the whole result set. */
declare const POI_FILTER_KEYS: readonly ["poiCategories", "brandSet", "connectorSet", "fuelSet", "minPowerKW", "maxPowerKW"];
type PoiFilterKey = (typeof POI_FILTER_KEYS)[number];
/**
 * Performs a fuzzy search for places, addresses, and POIs with advanced options
 */
export declare function fuzzySearch(query: string, options?: FuzzySearchOptions): Promise<DiscoverPlacesResponse>;
/**
 * Search specifically for Points of Interest (POIs)
 */
export declare function poiSearch(query: string, options?: PoiSearchOptions): Promise<Places>;
/**
 * Geocodes an address to coordinates
 */
export declare function geocodeAddress(query: string, options?: GeocodeOptions): Promise<GeocodingResponse>;
/**
 * Reverse geocodes coordinates to an address.
 * @param position [longitude, latitude] (GeoJSON convention)
 */
export declare function reverseGeocode(position: Position, options?: ReverseGeocodeOptions): Promise<ReverseGeocodingResponse>;
/**
 * Searches for points of interest (POIs) near a location.
 * @param position [longitude, latitude] (GeoJSON convention)
 */
export declare function searchNearby(position: Position, options?: NearbySearchOptions): Promise<DiscoverPlacesResponse>;
/**
 * Retrieves POI categories, optionally filtered by keywords
 */
export declare function fetchPOICategories(filters?: string[]): Promise<POICategoriesResponse>;
export type AreaSearchOptions = Pick<SearchSchema.AreaSearchParams, "query" | "center" | "radius" | "polygon" | "boundingBox" | "limit" | "poiCategories" | "language">;
/** The area to search: a circle, or a polygon drawn from the polygon or bounding box inputs. */
export type SearchArea = {
    kind: "circle";
    circle: Circle;
} | {
    kind: "polygon" | "boundingBox";
    polygon: Polygon;
};
/**
 * The search area from the tool inputs: center and radius, a polygon or a bounding
 * box. Throws when more than one is given. The handler draws the same area on the map.
 */
export declare function toSearchArea(params: Pick<AreaSearchOptions, "center" | "radius" | "polygon" | "boundingBox">): SearchArea | undefined;
/**
 * Search for POIs within a geometric area: a circle (center + radius), a
 * polygon, or a bounding box. Uses SDK's discoverPlaces() with that geometry.
 */
export declare function searchInArea(params: AreaSearchOptions): Promise<DiscoverPlacesResponse>;
export type EVSearchOptions = Pick<SearchSchema.EvSearchParams, "query" | "position" | "radius" | "connectorTypes" | "minPowerKW" | "limit" | "language" | "countries" | "cursor">;
/**
 * Search for EV charging stations using TomTom Maps SDK.
 *
 * Uses SDK's discoverPlaces() filtered to charging locations.
 */
export declare function searchEVStations(params: EVSearchOptions): Promise<Places>;
export interface SearchAlongRouteResult {
    route: Routes;
    pois: DiscoverPlacesResponse;
    summary: {
        routeLengthMeters: number | undefined;
        routeTravelTimeSeconds: number | undefined;
        poiCount: number;
        corridorWidthMeters: number;
    };
}
export type SearchAlongRouteOptions = Pick<SearchSchema.SearchAlongRouteParams, "origin" | "destination" | "query" | "corridorWidth" | "limit" | "poiCategories" | "language" | "routeType">;
/**
 * Search for POIs along a route corridor.
 *
 * Two-step process using SDK:
 * 1. calculateRoute() to get the route LineString geometry
 * 2. discoverPlaces() with the route geometry as a search corridor
 */
export declare function searchAlongRoute(params: SearchAlongRouteOptions): Promise<SearchAlongRouteResult>;
export {};
//# sourceMappingURL=searchService.d.ts.map