@tomtom-org/maps-sdk 0.57.0 → 0.58.0

package/core/dist/index.d.ts

@@ -446,13 +446,11 @@ type GetPositionOptions = {
  * * tomtom-user-agent - Name and version of this SDK
  * * Authorization - Bearer token for experimental OAuth2 support.
  * Based on the apiAccessToken parameter.
- * Tracking-ID - @see https://docs.tomtom.com/search-api/documentation/search-service/fuzzy-search#trackingid-request
  * @ignore
  */
 type TomTomHeaders = {
   'tomtom-user-agent'?: string;
   Authorization?: string;
-  'Tracking-ID'?: string;
 };
 /**
  * Service-specific TomTom API headers, declared per-request by a service's
@@ -1613,14 +1611,14 @@ export type CommonPlaceProps = {
 /**
  * Properties for reverse geocoded places.
  *
- * Extends common place properties with reverse geocoding-specific information
- * like the original query position and address interpolation details.
+ * Extends common place properties with the position the service matched. The feature's own
+ * `geometry` holds the position that was queried.
  *
  * @group Place
  */
 export type RevGeoAddressProps = CommonPlaceProps & {
   /**
-   * Original coordinates used in the reverse geocoding query [longitude, latitude].
+   * Coordinates the service matched the queried position to [longitude, latitude].
    */
   originalPosition: Position;
 };
@@ -1963,7 +1961,7 @@ type PoiDetailsDataSource = {
 /**
  * @group Place
  */
-export declare const poiCategories: readonly ["ACCESS_GATEWAY", "ADVENTURE_SPORTS_FACILITY", "ADVENTURE_VEHICLE_TRAIL", "ADVERTISING_COMPANY", "AFGHAN_RESTAURANT", "AFRICAN_RESTAURANT", "AGRICULTURAL_SUPPLIES", "AGRICULTURAL_TECHNOLOGY", "AGRICULTURE", "AIRFIELD", "AIRLINE_ACCESS", "AIRLINE_COMPANY", "AIRPORT", "AMBULANCE_UNIT", "AMERICAN_RESTAURANT", "AMPHITHEATER", "AMUSEMENT_PARK", "AMUSEMENT_PLACE", "ANIMAL_SERVICES", "ANIMAL_SHELTER", "ANTIQUE_ART_SHOP", "APARTMENT_RENTAL", "AQUATIC_ZOO", "ARABIAN_RESTAURANT", "ARBORETA_BOTANICAL_GARDENS", "ARCH", "ARMENIAN_RESTAURANT", "ART_SCHOOL", "ASIAN_RESTAURANT", "ATHLETICS_TRACK", "ATM", "ATV_DEALER", "AUSTRALIAN_RESTAURANT", "AUSTRIAN_RESTAURANT", "AUTOMOBILE_COMPANY", "AUTOMOBILE_MANUFACTURING", "AUTOMOTIVE_DEALER", "BAGS_LEATHERWEAR", "BAKERY", "BANK", "BANQUET_ROOMS", "BAR", "BARBECUE_RESTAURANT", "BASEBALL_PARK", "BASKETBALL_ARENA", "BASQUE_RESTAURANT", "BATTLEFIELD", "BAY", "BEACH", "BEACH_CLUB", "BEAUTY_SALON", "BEAUTY_SUPPLIES", "BELGIAN_RESTAURANT", "BETTING_STATION", "BISTRO", "BLOOD_BANK", "BOATING_EQUIPMENT_ACCESSORIES", "BOAT_DEALER", "BOAT_LAUNCHING_RAMP", "BODYSHOP", "BOLIVIAN_RESTAURANT", "BOOK_SHOP", "BOWLING_CENTER", "BRAZILIAN_RESTAURANT", "BRIDGE", "BRITISH_RESTAURANT", "BUFFET_RESTAURANT", "BUILDING", "BULGARIAN_RESTAURANT", "BUNGALOW_RENTAL", "BURMESE_RESTAURANT", "BUSINESS_PARK", "BUSINESS_SERVICES", "BUS_CHARTER_COMPANY", "BUS_DEALER", "BUS_LINES", "BUS_STOP", "BUTCHER", "B_B_GUEST_HOUSE", "CABARET_THEATER", "CABINS_LODGES", "CABLE_TELEPHONE_COMPANY", "CAFE", "CAFETERIA", "CAFE_PUB", "CALIFORNIAN_RESTAURANT", "CAMBODIAN_RESTAURANT", "CAMERAS_PHOTOGRAPHY", "CAMPING_GROUND", "CANADIAN_RESTAURANT", "CAPE", "CARAVAN_SITE", "CARIBBEAN_RESTAURANT", "CARPET_FLOOR_COVERINGS", "CAR_DEALER", "CAR_GLASS_REPLACEMENT_SHOP", "CAR_REPAIR_AND_SERVICE", "CAR_WASH", "CASINO", "CATERING_SERVICES", "CAVE", "CEMETERY", "CHALET_RENTAL", "CHEMICAL_COMPANY", "CHICKEN_RESTAURANT", "CHILDRENS_CLOTHES", "CHILD_CARE_FACILITY", "CHINESE_RESTAURANT", "CHRISTMAS_HOLIDAY_SHOP", "CHURCH", "CINEMA", "CLEANING_SERVICES", "CLOTHING_SHOP", "CLUB_ASSOCIATION", "COCKTAIL_BAR", "COFFEE_SHOP", "COLLEGE_OR_UNIVERSITY", "COLLEGE_UNIVERSITY", "COLOMBIAN_RESTAURANT", "COMEDY_CLUB", "COMMERCIAL_BUILDING", "COMMUNITY_CENTER", "COMPANY", "COMPUTER_COMPUTER_SUPPLIES", "COMPUTER_DATA_SERVICES", "CONCERT_HALL", "CONSTRUCTION_COMPANY", "CONSTRUCTION_MATERIAL_EQUIPMENT", "CONSUMER_ELECTRONICS", "CONVENIENCE_STORE", "CORSICAN_RESTAURANT", "COTTAGE_RENTAL", "COURIER_DROP_BOX", "COURTHOUSE", "COVE", "CREOLE_RESTAURANT", "CREPERIE", "CRICKET_GROUND", "CUBAN_RESTAURANT", "CULTURAL_CENTER", "CURRENCY_EXCHANGE", "CURTAINS_TEXTILES", "CZECH_RESTAURANT", "C_DS_DVD_VIDEOS", "DAM", "DANCE_STUDIO_SCHOOL", "DANISH_RESTAURANT", "DELICATESSEN", "DELIVERY_SERVICE", "DENTIST", "DEPARTMENT_STORE", "DINNER_THEATER", "DISCO_CLUB", "DIVERSIFIED_FINANCIALS", "DOCTOR", "DONGBEI_RESTAURANT", "DOUGHNUT_RESTAURANT", "DO_IT_YOURSELF_CENTERS", "DRIVE_IN_MOVIES", "DRIVE_THROUGH_BOTTLE_SHOP", "DRIVING_SCHOOL", "DRUG_STORE", "DRY_CLEANER", "DUNE", "DUTCH_RESTAURANT", "EGYPTIAN_RESTAURANT", "ELECTRICAL_APPLIANCES_SHOP", "ELECTRIC_VEHICLE_STATION", "ELECTRONICS_COMPANY", "EMBASSY", "EMERGENCY_MEDICAL_SERVICE", "EMERGENCY_ROOM", "ENGLISH_RESTAURANT", "ENTERTAINMENT", "EQUIPMENT_RENTAL", "ETHIOPIAN_RESTAURANT", "EXCHANGE", "EXHIBITION_CONVENTION_CENTER", "FACTORY_OUTLET", "FAIRGROUND", "FARM", "FARMERS_MARKET", "FAST_FOOD", "FERRY_TERMINAL", "FINNISH_RESTAURANT", "FIRE_STATION_BRIGADE", "FISHING_HUNTING_AREA", "FISHMONGER", "FITNESS_CLUB_CENTER", "FLATS_APARTMENT_COMPLEX", "FLORISTS", "FONDUE_RESTAURANT", "FOOD_MARKET", "FOOTBALL_STADIUM", "FOOTWEAR_SHOE_REPAIRS", "FOREST_AREA", "FRENCH_RESTAURANT", "FRONTIER_CROSSING", "FUNERAL_SERVICE_MORTUARIES", "FURNITURE_HOME_FURNISHINGS", "FUSION_RESTAURANT", "GARDEN_CENTERS_SERVICES", "GAS_STATION", "GENERAL_HOSPITAL_AND_POLYCLINIC", "GENERAL_PRACTITIONER", "GEOGRAPHIC_FEATURE", "GERMAN_RESTAURANT", "GIFTS_CARDS_NOVELTIES_SOUVENIRS", "GLASSWARE_CERAMIC_SHOP", "GLASS_WINDOWS_STORE", "GOLD_EXCHANGE", "GOLF_COURSE", "GOVERNMENT_OFFICE", "GREEK_RESTAURANT", "GREENGROCER", "GRILL_RESTAURANT", "GROCERY_STORE", "GURUDWARA", "HAIRDRESSER", "HAMBURGER_RESTAURANT", "HARBOR", "HARDWARE_STORE", "HAWAIIAN_RESTAURANT", "HEALTH_CARE_SERVICE", "HELIPAD_HELICOPTER_LANDING", "HIGH_SCHOOL", "HIKING_TRAIL", "HILL", "HISTORICAL_PARK", "HISTORIC_SITE", "HOBBY_SHOP", "HOCKEY_CLUB", "HOLIDAY_RENTAL", "HOME_APPLIANCE_REPAIR", "HORSE_RACING_TRACK", "HORSE_RIDING_CENTER", "HORSE_RIDING_TRAIL", "HORTICULTURE", "HOSPITAL", "HOSPITAL_FOR_WOMEN_AND_CHILDREN", "HOSPITAL_OF_CHINESE_MEDICINE", "HOSTEL", "HOTEL", "HOTEL_MOTEL", "HOT_POT_RESTAURANT", "HOUSE_GARDEN_FURNITURE_FITTINGS", "HUNAN_RESTAURANT", "HUNGARIAN_RESTAURANT", "ICE_CREAM_PARLOR", "ICE_HOCKEY_ARENA", "ICE_SKATING_RINK", "IMPORT_EXPORT_AND_DISTRIBUTION", "INDIAN_RESTAURANT", "INDONESIAN_RESTAURANT", "INDUSTRIAL_BUILDING", "INFORMAL_MARKET", "INSURANCE_COMPANY", "INTERNATIONAL_RAILROAD_STATION", "INTERNATIONAL_RESTAURANT", "INTERNET_CAFE", "INVESTMENT_ADVISOR", "IRANIAN_RESTAURANT", "IRISH_RESTAURANT", "ISLAND", "ISRAELI_RESTAURANT", "ITALIAN_RESTAURANT", "JAMAICAN_RESTAURANT", "JAPANESE_RESTAURANT", "JAZZ_CLUB", "JEWELRY_CLOCKS_WATCHES", "JEWISH_RESTAURANT", "JUNIOR_COLLEGE_COMMUNITY_COLLEGE", "KARAOKE_CLUB", "KITCHENS_BATHROOMS", "KOREAN_RESTAURANT", "KOSHER_RESTAURANT", "LANGUAGE_SCHOOL", "LATIN_AMERICAN_RESTAURANT", "LAUNDRY", "LEBANESE_RESTAURANT", "LEGAL_SERVICES", "LEISURE_CENTER", "LEISURE_SPORTS_CENTER", "LIBRARY", "LIGHTING_SHOPS", "LOCALE", "LOCAL_SPECIALITIES_SHOP", "LOTTERY_SHOP", "MANUFACTURING_COMPANY", "MANUFACTURING_FACILITY", "MARIJUANA_DISPENSARY", "MARINA", "MARKET", "MARSH", "MAUSOLEUM_GRAVE", "MECHANICAL_ENGINEERING", "MEDIA_FACILITY", "MEDICAL_SUPPLIES_EQUIPMENT", "MEDICINAL_MARIJUANA_DISPENSARY", "MEDITERRANEAN_RESTAURANT", "MEMORIAL", "MENS_CLOTHING", "MEXICAN_RESTAURANT", "MICROBREWERY", "MIDDLE_EASTERN_RESTAURANT", "MIDDLE_SCHOOL", "MILITARY_AIRPORT", "MINERAL_HOT_SPRINGS", "MINING_COMPANY", "MOBILE_PHONE_SHOP", "MONGOLIAN_RESTAURANT", "MONUMENT", "MOROCCAN_RESTAURANT", "MOSQUE", "MOTEL", "MOTORCYCLE_DEALER", "MOTORCYCLE_REPAIR", "MOTORING_ORGANIZATION_OFFICE", "MOTOR_RACING_STADIUM", "MOUNTAIN_BIKE_TRAIL", "MOUNTAIN_PASS", "MOUNTAIN_PEAK", "MOVIE_THEATER", "MOVING_STORAGE_COMPANY", "MULTI_PURPOSE_STADIUM", "MUSEUM", "MUSIC_CENTER", "MUSIC_INSTRUMENTS_STORE", "NAIL_SALON", "NATIONAL_RAILROAD_STATION", "NATIVE_RESERVATION", "NATURAL_TOURIST_ATTRACTION", "NEPALESE_RESTAURANT", "NETBALL_STADIUM", "NEWSAGENTS_TOBACCONISTS", "NIGHTLIFE", "NON_GOVERNMENTAL_ORGANIZATION", "NORWEGIAN_RESTAURANT", "OASIS", "OBSERVATORY", "OFFICE_EQUIPMENT", "OIL_NATURAL_GAS", "OPEN_CAR_PARKING_AREA", "OPEN_PARKING_AREA", "OPERA_HOUSE", "OPTICIAN", "ORGANIC_FOOD_RESTAURANT", "ORIENTAL_RESTAURANT", "OTHER_FOOD_SHOPS", "OTHER_WINTER_SPORT", "PAGODA", "PAINTING_DECORATING", "PAKISTANI_RESTAURANT", "PARK", "PARKING_GARAGE", "PARKWAY", "PARK_RECREATION_AREA", "PASSENGER_TRANSPORT_TICKET_OFFICE", "PAWN_SHOP", "PERSONAL_CARE_FACILITY", "PERSONAL_SERVICE", "PERFORMING_ARTS_THEATER", "PERUVIAN_RESTAURANT", "PET_SUPPLIES", "PHARMACEUTICAL_COMPANY", "PHARMACY", "PHILIPPINE_RESTAURANT", "PHOTOCOPY_SHOP", "PHOTO_LAB_DEVELOPMENT", "PICNIC_AREA", "PIZZERIA", "PLACE_OF_WORSHIP", "PLAIN_FLAT", "PLANETARIUM", "PLATEAU", "POLICE_STATION", "POLISH_RESTAURANT", "POLYNESIAN_RESTAURANT", "PORTUGUESE_RESTAURANT", "PORT_WAREHOUSE_FACILITY", "POST_OFFICE", "PRE_SCHOOL", "PRIMARY_PRODUCER", "PRIMARY_RESOURCE_UTILITY", "PRIMARY_SCHOOL", "PRISON_CORRECTIONAL_FACILITY", "PRIVATE_AIRPORT", "PROTECTED_AREA", "PUB", "PUBLIC_AIRPORT", "PUBLIC_AMENITY", "PUBLIC_CALL_BOX", "PUBLIC_MARKET", "PUBLIC_TOILET", "PUBLIC_TRANSPORT_STOP", "PUBLISHING_TECHNOLOGIES", "PUB_FOOD", "QUARRY", "RACE_TRACK", "RAILWAY_STATION", "RAPIDS", "REAL_ESTATE_AGENT", "REAL_ESTATE_COMPANY", "RECREATIONAL_CAMPING_GROUND", "RECREATIONAL_MARIJUANA_DISPENSARY", "RECREATIONAL_VEHICLE_DEALER", "RECREATION_AREA", "RECYCLING_SHOP", "REEF", "RENT_A_CAR_FACILITY", "RENT_A_CAR_PARKING", "REPAIR_FACILITY", "RESEARCH_FACILITY", "RESERVOIR", "RESIDENTIAL_ACCOMMODATION", "RESORT", "RESTAURANT", "RESTAURANT_AREA", "REST_AREA", "REST_CAMP", "RETAIL_OUTLET", "RETIREMENT_COMMUNITY", "RIDGE", "RIVER_CROSSING", "ROAD_RESCUE", "ROAD_TRAFFIC_CONTROL_CENTER", "ROCKS", "ROCK_CLIMBING_TRAIL", "RUGBY_GROUND", "RUSSIAN_RESTAURANT", "SALAD_BAR", "SANDWICH_RESTAURANT", "SAUNA_SOLARIUM_MASSAGE", "SCANDINAVIAN_RESTAURANT", "SCENIC_PANORAMIC_VIEW", "SCHOOL", "SCHOOL_BUS_COMPANY", "SEAFOOD", "SECURED_ENTRANCE", "SECURITY_PRODUCTS", "SENIOR_HIGH_SCHOOL", "SERVICE_COMPANY", "SHANDONG_RESTAURANT", "SHOP", "SHOPPING_CENTER", "SHOPPING_SERVICE", "SICHUAN_RESTAURANT", "SKI_RESORT", "SNACKS_RESTAURANT", "SNOOKER_POOL_BILLIARD", "SOCCER_STADIUM", "SOFTWARE_COMPANY", "SOUL_FOOD", "SOUP_RESTAURANT", "SPANISH_RESTAURANT", "SPECIALIST", "SPECIALTY_CLOTHING_SHOP", "SPECIALTY_FOODS", "SPECIAL_HOSPITAL", "SPORTS_CENTER", "SPORTS_EQUIPMENT_CLOTHING", "SQUASH_COURT", "STADIUM", "STATION_ACCESS", "STATUE", "STEAK_HOUSE", "STOCK_EXCHANGE", "STREETCAR_STOP", "SUBWAY_STATION", "SUPERMARKETS_HYPERMARKETS", "SUSHI_RESTAURANT", "SWEDISH_RESTAURANT", "SWIMMING_POOL", "SWISS_RESTAURANT", "SYNAGOG", "SYRIAN_RESTAURANT", "TAILOR_SHOP", "TAIWANESE_RESTAURANT", "TAKEOUT_FOOD", "TAPAS_RESTAURANT", "TAXI_LIMOUSINE_SHUTTLE_SERVICE", "TAXI_STAND", "TAX_SERVICES", "TEA_HOUSE", "TELECOMMUNICATIONS", "TEMPLE", "TENNIS_COURT", "TEPPANYAKI_RESTAURANT", "THAI_RESTAURANT", "THEATER", "THEMATIC_SPORT_CENTER", "TIBETAN_RESTAURANT", "TIRE_SERVICE", "TOLL_GATE", "TOURIST_ATTRACTION", "TOURIST_INFORMATION_OFFICE", "TOWER", "TOYS_GAMES_SHOP", "TRAFFIC_CONTROL_DEPARTMENT", "TRAIL_SYSTEM", "TRANSPORT_AUTHORITY_VEHICLE_REGISTRATION", "TRANSPORT_COMPANY", "TRAVEL_AGENT", "TRUCK_DEALER", "TRUCK_REPAIR_AND_SERVICE", "TRUCK_STOP", "TUNISIAN_RESTAURANT", "TUNNEL", "TURKISH_RESTAURANT", "URBAN_STATION", "VALLEY", "VAN_DEALER", "VARIETY_STORE", "VEGETARIAN_RESTAURANT", "VENEZUELAN_RESTAURANT", "VETERINARIAN", "VIDEO_RENTAL_SHOP", "VIETNAMESE_RESTAURANT", "VILLA_RENTAL", "VOCATIONAL_SCHOOL", "WATER_HOLE", "WATER_SPORT", "WEDDING_SERVICES", "WEIGH_STATION", "WELFARE_ORGANIZATION", "WELL", "WESTERN_RESTAURANT", "WHOLESALE_CLUB", "WILDERNESS_AREA", "WILDLIFE_PARK", "WINERY", "WINE_SPIRITS", "WOMENS_CLOTHING", "YACHT_BASIN", "YOGURT_JUICE_BAR", "ZOO", "ZOOS_ARBORETA_BOTANICAL_GARDEN"];
+export declare const poiCategories: readonly ["ABORIGINAL_LAND", "ADVENTURE_SPORTS_FACILITY", "ADVENTURE_VEHICLE_TRAIL", "ADVERTISING_COMPANY", "AFGHAN_RESTAURANT", "AFRICAN_RESTAURANT", "AGRICULTURAL_SUPPLIES", "AGRICULTURAL_TECHNOLOGY", "AGRICULTURE", "AIRFIELD", "AIRLINE_ACCESS", "AIRLINE_COMPANY", "AIRPORT", "AMBULANCE_UNIT", "AMERICAN_RESTAURANT", "AMPHITHEATER", "AMUSEMENT_PARK", "AMUSEMENT_PLACE", "ANIMAL_SERVICE", "ANIMAL_SHELTER", "ANTIQUE_ART_SHOP", "APARTMENT_RENTAL", "AQUATIC_ZOO", "ARABIAN_RESTAURANT", "ARBORETA_AND_BOTANICAL_GARDENS", "ARCH", "ARMENIAN_RESTAURANT", "ART_SCHOOL", "ASIAN_RESTAURANT", "ATHLETICS_TRACK", "ATM", "ATV_DEALER", "AUSTRALIAN_RESTAURANT", "AUSTRIAN_RESTAURANT", "AUTOMOBILE_COMPANY", "AUTOMOBILE_MANUFACTURING", "BAGS_LEATHERWEAR", "BAKERY", "BANDB_OR_GUEST_HOUSE", "BANK", "BANQUET_ROOMS", "BAR", "BARBECUE_RESTAURANT", "BASEBALL_PARK", "BASKETBALL_ARENA", "BASQUE_RESTAURANT", "BATTLEFIELD", "BAY", "BEACH", "BEACH_CLUB", "BEAUTY_SALON", "BEAUTY_SUPPLIES", "BELGIAN_RESTAURANT", "BETTING_STATION", "BISTRO", "BLOOD_BANK", "BOATING_EQUIPMENT_AND_ACCESSORIES", "BOAT_DEALER", "BOAT_LAUNCHING_RAMP", "BODYSHOP", "BOLIVIAN_RESTAURANT", "BOOK_SHOP", "BORDER_CONTROL", "BOWLING_CENTER", "BRAZILIAN_RESTAURANT", "BRIDGE", "BRITISH_RESTAURANT", "BUFFET_RESTAURANT", "BUILDING", "BULGARIAN_RESTAURANT", "BUNGALOW_RENTAL", "BURMESE_RESTAURANT", "BUSINESS_PARK", "BUSINESS_SERVICES", "BUS_CHARTER_COMPANY", "BUS_DEALER", "BUS_LINES", "BUS_STOP", "BUTCHER", "CABARET_THEATER", "CABINS_LODGES", "CABLE_AND_TELEPHONE_COMPANY", "CAFE", "CAFETERIA", "CAFE_PUB", "CALIFORNIAN_RESTAURANT", "CAMBODIAN_RESTAURANT", "CAMERAS_AND_PHOTOGRAPHY", "CAMPING_GROUND", "CANADIAN_RESTAURANT", "CANNABIS_SHOP", "CAPE", "CARAVAN_SITE", "CARIBBEAN_RESTAURANT", "CARPET_FLOOR_COVERINGS", "CAR_DEALER", "CAR_GLASS_REPLACEMENT_SHOP", "CAR_RENTAL", "CAR_REPAIR_AND_SERVICE", "CAR_WASH", "CASINO_AND_GAMBLING", "CATERING_SERVICES", "CAVE", "CEMETERY", "CHALET_RENTAL", "CHARGING_LOCATION", "CHEMICAL_COMPANY", "CHICKEN_RESTAURANT", "CHILDCARE", "CHILDREN_S_CLOTHES", "CHILEAN_RESTAURANT", "CHINESE_RESTAURANT", "CHRISTMAS_OR_HOLIDAY_SHOP", "CHURCH", "CINEMA", "CLEANING_SERVICES", "CLOTHING_SHOP", "CLUB_AND_ASSOCIATION", "COCKTAIL_BAR", "COFFEE_SHOP", "COLLEGE_OR_UNIVERSITY", "COLOMBIAN_RESTAURANT", "COMEDY_CLUB", "COMMERCIAL_BUILDING", "COMMUNITY_CENTER", "COMPANY", "COMPUTER_AND_COMPUTER_SUPPLIES", "COMPUTER_AND_DATA_SERVICES", "CONCERT_HALL", "CONSTRUCTION_COMPANY", "CONSTRUCTION_MATERIAL_AND_EQUIPMENT", "CONSUMER_ELECTRONICS", "CONVENIENCE_STORE", "CORSICAN_RESTAURANT", "COTTAGE_RENTAL", "COURIER_DROP_BOX", "COURTHOUSE", "COVE", "CREOLE_RESTAURANT", "CREPERIE", "CRICKET_GROUND", "CUBAN_RESTAURANT", "CULTURAL_CENTER", "CURTAINS_TEXTILES", "CZECH_RESTAURANT", "C_DS_DVD_VIDEOS", "DAM", "DANCE_STUDIO_AND_SCHOOL", "DANISH_RESTAURANT", "DELICATESSEN", "DELIVERY_SERVICE", "DENTIST", "DEPARTMENT_STORE", "DINNER_THEATER", "DISCO_CLUB", "DIVERSIFIED_FINANCIALS", "DOCTOR", "DONGBEI_RESTAURANT", "DOUGHNUT_RESTAURANT", "DO_IT_YOURSELF_CENTERS", "DRIVE_IN_MOVIES", "DRIVE_THROUGH_BOTTLE_SHOP", "DRIVING_SCHOOL", "DRUG_STORE", "DRY_CLEANER", "DUNE", "DUTCH_RESTAURANT", "EGYPTIAN_RESTAURANT", "ELECTRICAL_APPLIANCES_SHOP", "ELECTRONICS_COMPANY", "EMBASSY", "EMERGENCY_MEDICAL_SERVICE", "EMERGENCY_ROOM", "ENGLISH_RESTAURANT", "ENTERTAINMENT", "EQUIPMENT_RENTAL", "ETHIOPIAN_RESTAURANT", "EXCHANGE", "EXHIBITION_CONVENTION_CENTER", "FACTORY_OUTLET", "FAIRGROUND", "FARM", "FARMERS_MARKET", "FAST_FOOD", "FERRY_TERMINAL", "FINNISH_RESTAURANT", "FIRE_STATION", "FISHING_AND_HUNTING_AREA", "FISHMONGER", "FITNESS_CLUB_AND_CENTER", "FLATS_OR_APARTMENT_COMPLEX", "FLORISTS", "FLYING_CLUB", "FONDUE_RESTAURANT", "FOOD_AND_DRINKS_SHOP", "FOOD_MARKET", "FOOTBALL_STADIUM", "FOOTWEAR_SHOE_REPAIRS", "FOREIGN_EXCHANGE", "FOREST_AREA", "FRENCH_RESTAURANT", "FUEL_STATION", "FUNERAL_SERVICE_AND_MORTUARIES", "FURNITURE_HOME_FURNISHINGS", "FUSION_RESTAURANT", "GARDEN_CENTERS_SERVICES", "GENERAL_HOSPITAL_AND_POLYCLINIC", "GENERAL_PRACTITIONER", "GERMAN_RESTAURANT", "GIFTS_CARDS_NOVELTIES_SOUVENIRS", "GLASSWARE_CERAMIC_SHOP", "GLASS_WINDOWS_STORE", "GOLD_EXCHANGE", "GOLF_COURSE", "GOVERNMENT_OFFICE", "GREEK_RESTAURANT", "GREENGROCER", "GRILL_RESTAURANT", "GROCERY_STORE", "GURUDWARA", "HAIRDRESSER", "HAMBURGER_RESTAURANT", "HARBOR", "HARDWARE_STORE", "HAWAIIAN_RESTAURANT", "HEALTHCARE_SERVICE", "HELIPORT_OR_HELIPAD", "HIGH_SCHOOL", "HIKING_TRAIL", "HILL", "HISTORICAL_PARK", "HISTORIC_SITE", "HOBBY_SHOP", "HOCKEY_CLUB", "HOLIDAY_RENTAL", "HOME_APPLIANCE_REPAIR", "HORSE_RACING_TRACK", "HORSE_RIDING", "HORSE_RIDING_TRAIL", "HORTICULTURE", "HOSPITAL", "HOSPITAL_FOR_WOMEN_AND_CHILDREN", "HOSPITAL_OF_CHINESE_MEDICINE", "HOSTEL", "HOTEL", "HOTEL_OR_MOTEL", "HOT_POT_RESTAURANT", "HOUSE_AND_GARDEN_FURNITURE_AND_FITTINGS", "HUNAN_RESTAURANT", "HUNGARIAN_RESTAURANT", "ICE_CREAM_PARLOR", "ICE_HOCKEY_ARENA", "ICE_RINK", "IMPORT_OR_EXPORT_AND_DISTRIBUTION", "INDIAN_RESTAURANT", "INDONESIAN_RESTAURANT", "INDUSTRIAL_BUILDING", "INFORMAL_MARKET", "INSURANCE_COMPANY", "INTERNATIONAL_RAILROAD_STATION", "INTERNATIONAL_RESTAURANT", "INTERNET_CAFE", "INVESTMENT_ADVISOR", "IRANIAN_RESTAURANT", "IRISH_RESTAURANT", "ISLAND", "ISRAELI_RESTAURANT", "ITALIAN_RESTAURANT", "JAMAICAN_RESTAURANT", "JAPANESE_RESTAURANT", "JAZZ_CLUB", "JEWELRY_CLOCKS_WATCHES", "JEWISH_RESTAURANT", "JUICE_BAR", "JUNIOR_COLLEGE_OR_COMMUNITY_COLLEGE", "KARAOKE_CLUB", "KITCHENS_BATHROOMS", "KOREAN_RESTAURANT", "KOSHER_RESTAURANT", "LANGUAGE_SCHOOL", "LATIN_AMERICAN_RESTAURANT", "LAUNDRY", "LEBANESE_RESTAURANT", "LEGAL_SERVICES", "LEISURE_CENTER", "LIGHTING_SHOPS", "LOCALE", "LOCAL_SPECIALITIES_SHOP", "LOTTERY_SHOP", "MALL", "MANUFACTURING_COMPANY", "MANUFACTURING_FACILITY", "MARINA", "MARKETPLACE", "MARSH", "MAUSOLEUM_OR_GRAVE", "MECHANICAL_ENGINEERING", "MEDIA_FACILITY", "MEDICAL_SUPPLIES_EQUIPMENT", "MEDICINAL_AND_RECREATIONAL_DISPENSARY", "MEDICINAL_MARIJUANA_DISPENSARY", "MEDITERRANEAN_RESTAURANT", "MEMORIAL", "MEN_S_CLOTHING", "MEXICAN_RESTAURANT", "MICROBREWERY", "MIDDLE_EASTERN_RESTAURANT", "MIDDLE_SCHOOL", "MILITARY_AIRPORT", "MINERAL_OR_HOT_SPRINGS", "MINING_COMPANY", "MOBILE_PHONE_SHOP", "MONGOLIAN_RESTAURANT", "MONUMENT", "MOROCCAN_RESTAURANT", "MOSQUE", "MOTEL", "MOTORCYCLE_DEALER", "MOTORCYCLE_REPAIR", "MOTORING_ORGANIZATION_OFFICE", "MOTOR_RACING_STADIUM", "MOUNTAIN_BIKE_TRAIL", "MOUNTAIN_PASS", "MOUNTAIN_PEAK", "MOVIE_THEATER", "MOVING_AND_STORAGE_COMPANY", "MULTI_PURPOSE_STADIUM", "MUSEUM", "MUSIC_CENTER", "MUSIC_INSTRUMENTS_STORE", "NAIL_SALON", "NATIONAL_RAILROAD_STATION", "NATURAL_FEATURE", "NATURAL_TOURIST_ATTRACTION", "NEPALESE_RESTAURANT", "NETBALL_STADIUM", "NEWSAGENTS_TOBACCONISTS", "NIGHTLIFE", "NON_GOVERNMENTAL_ORGANIZATION", "NORWEGIAN_RESTAURANT", "OASIS", "OBSERVATORY", "OFFICE_EQUIPMENT", "OIL_AND_NATURAL_GAS", "OPEN_CAR_PARKING_AREA", "OPERA_HOUSE", "OPTICIAN", "ORGANIC_FOOD_RESTAURANT", "ORIENTAL_RESTAURANT", "PAGODA", "PAINTING_DECORATING", "PAKISTANI_RESTAURANT", "PAN", "PARK", "PARKING_GARAGE", "PARKWAY", "PARK_AND_RECREATION_AREA", "PASSENGER_TRANSPORT_TICKET_OFFICE", "PAWN_SHOP", "PEDESTRIAN_SUBWAY", "PERSONAL_CARE_FACILITY", "PERSONAL_SERVICE", "PERUVIAN_RESTAURANT", "PET_SUPPLIES", "PHARMACEUTICAL_COMPANY", "PHARMACY", "PHILIPPINE_RESTAURANT", "PHOTOCOPY_SHOP", "PHOTO_LAB_OR_DEVELOPMENT", "PICNIC_AREA", "PIZZERIA", "PLAIN_OR_FLAT", "PLANETARIUM", "PLATEAU", "POLICE_STATION", "POLISH_RESTAURANT", "PORTUGUESE_RESTAURANT", "PORT_WAREHOUSE_FACILITY", "POST_OFFICE", "PRE_SCHOOL", "PRIMARY_PRODUCER", "PRIMARY_RESOURCE_UTILITY", "PRIMARY_SCHOOL", "PRISON", "PRIVATE_AIRPORT", "PROTECTED_LAND", "PUB", "PUBLIC_AIRPORT", "PUBLIC_AMENITY", "PUBLIC_BATHROOM", "PUBLIC_CALL_BOX", "PUBLIC_LIBRARY", "PUBLIC_MARKET", "PUBLIC_TRANSPORT_STOP", "PUBLISHING_TECHNOLOGIES", "QUARRY", "RACE_TRACK", "RAILWAY_STATION", "RAPIDS", "REAL_ESTATE_AGENT", "REAL_ESTATE_COMPANY", "RECREATIONAL_CAMPING_GROUND", "RECREATIONAL_MARIJUANA_DISPENSARY", "RECREATIONAL_VEHICLE_DEALER", "RECREATION_AREA", "RECYCLING_SHOP", "REEF", "RELIGIOUS_SITE", "RENTAL_CAR_PARKING", "RESCUE_SERVICE", "RESEARCH_FACILITY", "RESERVOIR", "RESIDENTIAL_ACCOMMODATION", "RESIDENTIAL_ENTRANCE", "RESORT", "RESTAURANT", "RESTAURANT_AREA", "REST_AREA", "REST_CAMP", "RETAIL_OUTLET", "RETIREMENT_COMMUNITY", "RIDGE", "RIVER_CROSSING", "ROCKS", "ROCK_CLIMBING_TRAIL", "RUGBY_GROUND", "RUSSIAN_RESTAURANT", "SALAD_BAR", "SANDWICH_RESTAURANT", "SAUNA_SOLARIUM_MASSAGE", "SCANDINAVIAN_RESTAURANT", "SCHOOL", "SCHOOL_BUS_COMPANY", "SEAFOOD", "SECURED_ENTRANCE", "SECURITY_PRODUCTS", "SENIOR_HIGH_SCHOOL", "SERVICE_COMPANY", "SHANDONG_RESTAURANT", "SHOPPING_SERVICE", "SHOP_OR_STORE", "SICHUAN_RESTAURANT", "SKI_RESORT", "SNACKS_RESTAURANT", "SOCCER_STADIUM", "SOFTWARE_COMPANY", "SOUL_FOOD", "SOUP_RESTAURANT", "SPANISH_RESTAURANT", "SPECIALIST", "SPECIALTY_CLOTHING_SHOP", "SPECIALTY_FOODS", "SPECIAL_HOSPITAL", "SPORTS_CENTER", "SPORTS_EQUIPMENT_AND_CLOTHING", "SQUASH_COURT", "STADIUM", "STATION_ACCESS", "STATUE", "STEAK_HOUSE", "STOCK_EXCHANGE", "STREETCAR_STOP", "SUBWAY_ENTRANCE", "SUBWAY_STATION", "SUPERMARKET", "SUSHI_RESTAURANT", "SWEDISH_RESTAURANT", "SWIMMING_POOL", "SWISS_RESTAURANT", "SYNAGOG", "SYRIAN_RESTAURANT", "TAILOR_SHOP", "TAIWANESE_RESTAURANT", "TAKEOUT_FOOD", "TAPAS_RESTAURANT", "TAXI_LIMOUSINE_AND_SHUTTLE_SERVICE", "TAXI_STAND", "TAX_SERVICES", "TEA_HOUSE", "TELECOMMUNICATIONS", "TEMPLE", "TENNIS_COURT", "TEPPANYAKI_RESTAURANT", "THAI_RESTAURANT", "THEATER", "THEMATIC_SPORT_CENTER", "TIBETAN_RESTAURANT", "TIRE_SERVICE", "TOLL_GATE", "TOURIST_ATTRACTION", "TOURIST_INFORMATION", "TOWER", "TOYS_GAMES_SHOP", "TRAFFIC_CONTROL_DEPARTMENT", "TRAIL_SYSTEM", "TRANSPORT_ACCESS", "TRANSPORT_AUTHORITY_VEHICLE_REGISTRATION", "TRANSPORT_COMPANY", "TRAVEL_AGENT", "TRUCK_DEALER", "TRUCK_REPAIR_AND_SERVICE", "TRUCK_STOP", "TUNISIAN_RESTAURANT", "TUNNEL", "TURKISH_RESTAURANT", "URBAN_STATION", "VALLEY", "VAN_DEALER", "VARIETY_STORE", "VEGETARIAN_RESTAURANT", "VEHICLE_DEALER", "VEHICLE_REPAIR", "VENEZUELAN_RESTAURANT", "VETERINARY", "VIDEO_RENTAL_SHOP", "VIETNAMESE_RESTAURANT", "VIEWPOINT", "VILLA_RENTAL", "VOCATIONAL_SCHOOL", "WATER_HOLE", "WATER_SPORT", "WEDDING_SERVICES", "WEIGH_STATION", "WELFARE_ORGANIZATION", "WELL", "WESTERN_RESTAURANT", "WHOLESALE_CLUB", "WILDERNESS_AREA", "WILDLIFE_PARK", "WINERY", "WINE_SPIRITS", "WOMEN_S_CLOTHING", "YACHT_BASIN", "ZOO", "ZOOS_ARBORETA_BOTANICAL_GARDEN"];
 /**
  * @group Place
  */
@@ -2078,7 +2076,7 @@ type POI = {
   /**
    * Standardized category identifiers for the POI.
    *
-   * Machine-readable category names from the {@link POICategory} enum (e.g., `'ITALIAN_RESTAURANT'`, `'GAS_STATION'`, `'HOTEL'`).
+   * Machine-readable category names from the {@link POICategory} enum (e.g., `'ITALIAN_RESTAURANT'`, `'FUEL_STATION'`, `'HOTEL'`).
    * Use these for filtering, programmatic category matching, or mapping to icons.
    * Parsed from the numeric category IDs returned by the API.
    */
@@ -2592,24 +2590,15 @@ type RoutePathPoint = {
   travelTimeInSeconds: number;
 };
 /**
- * Text with phonetic transcription.
+ * A name shown in a guidance instruction: a street, road number, exit, intersection, tollgate or
+ * country.
  * @group Route
  */
-type TextWithPhonetics = {
+type InstructionText = {
   /**
    * The name as a text string.
    */
   text: string;
-  /**
-   * The phonetic transcription of the name.
-   * Included if phonetic transcription is available for the specific name, and phonetic transcriptions have been requested by the client.
-   * Note: The phonetic transcription can contain double quote characters ("). In this case those characters are escaped with a backslash (\).
-   */
-  phonetic?: string;
-  /**
-   * Encodes the language using an IETF language tag, e.g., en-GB, en-US.
-   */
-  phoneticLanguageCode?: string;
 };
 /**
  * Object describes a single road shield reference.
@@ -2637,10 +2626,10 @@ type RoadShield = {
   /**
    * The road number. Most road numbers have a 'letter' prefix, which is also returned.
    */
-  roadNumber: TextWithPhonetics;
+  roadNumber: InstructionText;
   /**
    * Information allowing the client to build an image of the road shield using the TomTom RoadShield API.
-   * Included if instructionRoadShieldReferences was requested.
+   * Included if a road shield image is available for this road.
    */
   roadShieldReference?: RoadShieldReference;
   /**
@@ -2666,7 +2655,7 @@ type RoadInformation = {
    * The street name for the road.
    * Included if street name is available for this road.
    */
-  streetName?: TextWithPhonetics;
+  streetName?: InstructionText;
   /**
    * Lists the road shields for this road.
    * The list can be empty if no road shields are available.
@@ -2686,16 +2675,16 @@ type Signpost = {
    * Exit name of the controlled access road.
    * Included if an exit name is available for this signpost.
    */
-  exitName?: TextWithPhonetics;
+  exitName?: InstructionText;
   /**
    * Exit number of the controlled access road. Included if an exit number is available for this signpost.
    * Multiple exit numbers can be encoded in the string, e.g. "E10/E12". If exit number is not available, the field will be absent.
    */
-  exitNumber?: TextWithPhonetics;
+  exitNumber?: InstructionText;
   /**
    * The toward name from the signpost.
    */
-  towardName: TextWithPhonetics;
+  towardName: InstructionText;
 };
 /**
  * Side road information.
@@ -2797,7 +2786,7 @@ type Instruction = {
    * Name of the intersection at which the maneuver must be performed.
    * Included if intersection name is available for this maneuver.
    */
-  intersectionName?: TextWithPhonetics;
+  intersectionName?: InstructionText;
   /**
    * Indicates left-hand vs. right-hand side driving at the point of the maneuver.
    */
@@ -2911,7 +2900,7 @@ type Instruction = {
    * The name of the tollgate, if available.
    * Included if the maneuver is a tollgate maneuver, i.e., maneuver is TOLLGATE.
    */
-  tollgateName?: TextWithPhonetics;
+  tollgateName?: InstructionText;
   /**
    * Included if the maneuver is a tollgate maneuver, i.e., maneuver is TOLLGATE.
    * Array containing one or more available toll payment options for this tollgate.
@@ -2926,7 +2915,7 @@ type Instruction = {
    * LEAVE_SHIP_FERRY
    * LEAVE_CAR_TRAIN
    */
-  countryCrossingFromName?: TextWithPhonetics;
+  countryCrossingFromName?: InstructionText;
   /**
    * The code (ISO 3166-1 alpha-3) of the country the border crossing occurs from.
    * Included if the maneuver is a border crossing maneuver, i.e., maneuver is one of:
@@ -2946,7 +2935,7 @@ type Instruction = {
    * LEAVE_SHIP_FERRY
    * LEAVE_CAR_TRAIN
    */
-  countryCrossingToName?: TextWithPhonetics;
+  countryCrossingToName?: InstructionText;
   /**
    * The code (ISO 3166-1 alpha-3) of the country the border crossing occurs to.
    * Included if the maneuver is a border crossing maneuver, i.e., maneuver is one of:
@@ -3429,12 +3418,10 @@ export type DelayMagnitude = 'unknown' | 'minor' | 'moderate' | 'major' | 'indef
  * @remarks
  * Strict subset of {@link fullTrafficIncidentCategories} — every value here is also
  * a valid response category. The two values omitted (`'animals-on-road'` and
- * `'narrow-lanes'`) are documented as response-only: the upstream's default-values
- * list is `0,1,2,3,4,5,6,7,8,9,10,11,14`, intentionally excluding iconCategory 12
- * and 13. Including either makes the upstream reject the whole filter with
- * `Unsupported categoryFilter parameter value`.
+ * `'narrow-lanes'`) have no Incident Details category: they only appear on traffic
+ * vector-tile features.
  *
- * @see https://docs.tomtom.com/traffic-api/documentation/tomtom-orbis-maps/traffic-incidents/incident-details
+ * @see https://docs.tomtom.com/traffic-api/documentation/tomtom-orbis-maps/v2/traffic-incidents/incident-details
  * @group Traffic
  */
 export declare const trafficIncidentRequestCategories: readonly ["accident", "broken-down-vehicle", "danger", "flooding", "fog", "frost", "jam", "lane-closed", "other", "rain", "road-closed", "roadworks", "wind"];
@@ -3443,9 +3430,9 @@ export declare const trafficIncidentRequestCategories: readonly ["accident", "br
  *
  * @remarks
  * Composed of {@link trafficIncidentRequestCategories} (categories that can be both
- * sent as filter inputs and received in responses) plus the response-only categories
- * `'animals-on-road'` and `'narrow-lanes'`, which appear in API responses and on
- * vector-tile features but are rejected as `categoryFilter` inputs. Use this list
+ * sent as filter inputs and received in responses) plus the tile-only categories
+ * `'animals-on-road'` and `'narrow-lanes'`, which appear on vector-tile features
+ * but never in an Incident Details response or filter. Use this list
  * when a category can be *received*; use {@link trafficIncidentRequestCategories}
  * when a category must be *sent* to the Incident Details API as a `categoryFilter`
  * input.
@@ -3508,51 +3495,6 @@ export type TrafficIncidentProbability = 'certain' | 'probable' | 'risk_of' | 'i
  * @group Traffic
  */
 export type TrafficIncidentTimeValidity = 'present' | 'future';
-/**
- * A single TMC (Traffic Message Channel) location point.
- *
- * @group Traffic
- */
-export type TrafficIncidentTMCPoint = {
-  /**
-   * TMC location code.
-   */
-  location: number;
-  /**
-   * Offset from the TMC location in the direction of the incident.
-   */
-  offset?: number;
-};
-/**
- * Traffic Message Channel (TMC) data associated with a traffic incident.
- *
- * TMC is an international standard for encoding traffic and travel information
- * in FM radio broadcasts (RDS-TMC) and digital data streams.
- *
- * @group Traffic
- */
-export type TrafficIncidentTMC = {
-  /**
-   * ISO 3166-1 alpha-2 country code.
-   */
-  countryCode: string;
-  /**
-   * TMC table number.
-   */
-  tableNumber: string;
-  /**
-   * TMC table version.
-   */
-  tableVersion: string;
-  /**
-   * Direction of the incident along the TMC path.
-   */
-  direction: 'positive' | 'negative';
-  /**
-   * Ordered list of TMC location points describing the incident extent.
-   */
-  points: TrafficIncidentTMCPoint[];
-};
 /**
  * A single event contributing to a traffic incident.
  *
@@ -3653,10 +3595,6 @@ export type TrafficIncidentProperties = TrafficIncidentBaseProperties & {
    * Whether the incident is currently active or expected in the future.
    */
   timeValidity: TrafficIncidentTimeValidity;
-  /**
-   * TMC data for the incident, if available.
-   */
-  tmc?: TrafficIncidentTMC;
 };
 /**
  * A GeoJSON Feature representing a single traffic incident.
@@ -4457,76 +4395,123 @@ export type AreaAnalyticsMetrics = {
   networkLength?: number;
 };
 /**
- * A single time-series data entry with temporal identifiers and metric values.
+ * A `yearly` entry of {@link AreaAnalyticsTimedData}.
  *
- * @remarks
- * The identifiers present depend on the granularity:
- * - `yearly`: `year`
- * - `monthly`: `year`, `month`
- * - `weekly`: `year`, `week`
- * - `daily`: `date`
- * - `hourly`: `date`, `hour`
- * - `average`: `day`, `hour` (weekly pattern by day-of-week and hour)
+ * @group Traffic
+ */
+export type AreaAnalyticsYearlyEntry = AreaAnalyticsMetrics & {
+  /**
+   * Calendar year (e.g. 2024).
+   */
+  year: number;
+};
+/**
+ * A `monthly` entry of {@link AreaAnalyticsTimedData}.
+ *
+ * @group Traffic
+ */
+export type AreaAnalyticsMonthlyEntry = AreaAnalyticsYearlyEntry & {
+  /**
+   * Calendar month (1–12).
+   */
+  month: number;
+};
+/**
+ * A `weekly` entry of {@link AreaAnalyticsTimedData}: an ISO 8601 week, from Monday.
  *
  * @group Traffic
  */
-export type AreaAnalyticsTimedEntry = AreaAnalyticsMetrics & {
+export type AreaAnalyticsWeeklyEntry = AreaAnalyticsMetrics & {
   /**
-   * Date for daily and hourly entries.
+   * ISO 8601 year that `week` counts in, which can differ from the calendar year at the turn of the year: the
+   * week from Monday 30 December 2024 is week 1 of 2025.
    */
-  date?: Date;
+  year: number;
   /**
-   * Calendar year (e.g. 2024) for yearly, monthly, and weekly entries.
+   * ISO 8601 week number (1–53).
    */
-  year?: number;
+  week: number;
+};
+/**
+ * A `daily` entry of {@link AreaAnalyticsTimedData}.
+ *
+ * @group Traffic
+ */
+export type AreaAnalyticsDailyEntry = AreaAnalyticsMetrics & {
   /**
-   * Calendar month (1–12) for monthly entries.
+   * Calendar day, at midnight UTC: read it with `toISOString()` or `getUTCDate()`.
    */
-  month?: number;
+  date: Date;
+};
+/**
+ * An `hourly` entry of {@link AreaAnalyticsTimedData}.
+ *
+ * @group Traffic
+ */
+export type AreaAnalyticsHourlyEntry = AreaAnalyticsDailyEntry & {
   /**
-   * ISO week number for weekly entries.
+   * Hour of the day (0–23).
    */
-  week?: number;
+  hour: number;
+};
+/**
+ * An `average` entry of {@link AreaAnalyticsTimedData}: one hour of the average week.
+ *
+ * @group Traffic
+ */
+export type AreaAnalyticsAverageEntry = AreaAnalyticsMetrics & {
   /**
-   * Hour of the day (0–23) for hourly and average entries.
+   * Day of the week (1 = Monday … 7 = Sunday).
    */
-  hour?: number;
+  day: 1 | 2 | 3 | 4 | 5 | 6 | 7;
   /**
-   * Day of the week (1 = Monday … 7 = Sunday) for average entries.
+   * Hour of the day (0–23).
    */
-  day?: number;
+  hour: number;
 };
 /**
  * Time-series traffic data organized by granularity level.
  *
+ * Each granularity holds only the periods with data: an `hours` filter, a `days` list or a day without data
+ * leaves entries out, so read an entry's time identifiers rather than its array index.
+ *
+ * Every time identifier is in UTC, as the `hours` filter is: the request names no region timezone, so the API
+ * labels its periods in UTC.
+ *
  * @group Traffic
  */
 export type AreaAnalyticsTimedData = {
   /**
-   * Yearly aggregated data.
+   * Yearly aggregated data, oldest first.
    */
-  yearly?: AreaAnalyticsTimedEntry[];
+  yearly?: AreaAnalyticsYearlyEntry[];
   /**
-   * Monthly aggregated data.
+   * Monthly aggregated data, oldest first.
    */
-  monthly?: AreaAnalyticsTimedEntry[];
+  monthly?: AreaAnalyticsMonthlyEntry[];
   /**
-   * Weekly aggregated data.
+   * Weekly aggregated data, oldest first.
    */
-  weekly?: AreaAnalyticsTimedEntry[];
+  weekly?: AreaAnalyticsWeeklyEntry[];
   /**
-   * Daily aggregated data.
+   * Daily aggregated data, oldest first.
    */
-  daily?: AreaAnalyticsTimedEntry[];
+  daily?: AreaAnalyticsDailyEntry[];
   /**
-   * Hourly aggregated data.
+   * Hourly aggregated data, oldest first.
    */
-  hourly?: AreaAnalyticsTimedEntry[];
+  hourly?: AreaAnalyticsHourlyEntry[];
   /**
-   * Average weekly traffic pattern organized by day-of-week and hour.
+   * Average weekly traffic pattern: one entry per day of the week and hour, Monday first, then by hour.
    */
-  average?: AreaAnalyticsTimedEntry[];
+  average?: AreaAnalyticsAverageEntry[];
 };
+/**
+ * An entry of any {@link AreaAnalyticsTimedData} granularity.
+ *
+ * @group Traffic
+ */
+export type AreaAnalyticsTimedEntry = NonNullable<AreaAnalyticsTimedData[keyof AreaAnalyticsTimedData]>[number];
 /**
  * Traffic metrics for a single geographic tile within the analysis region.
  *
@@ -4544,21 +4529,21 @@ export type AreaAnalyticsTileEntry = AreaAnalyticsMetrics & {
   tileCentre: Position;
 };
 /**
- * A detected anomaly for a specific data type within the analysis period.
+ * A run of hours in which one metric departs from its usual values, in UTC like {@link AreaAnalyticsTimedData}.
  *
  * @group Traffic
  */
 export type AreaAnalyticsAnomaly = {
   /**
-   * Start of the anomaly period.
+   * Start of the first anomalous hour.
    */
   startDate: Date;
   /**
-   * End of the anomaly period.
+   * End of the last anomalous hour, exclusive: the start of the hour after it.
    */
   endDate: Date;
   /**
-   * Labels describing the anomaly (e.g. `'Holiday'`, `'Weather event'`).
+   * Names of the public holidays overlapping the anomaly in the region's country (e.g. `'Christmas Day'`), if any.
    */
   labels: string[];
 };
@@ -4573,9 +4558,9 @@ export type AreaAnalyticsFeatureProperties = {
    */
   name: string;
   /**
-   * IANA timezone identifier for the region (e.g. `'Europe/Amsterdam'`).
+   * IANA timezone the API echoes from a request that names one; the SDK names none, so this is absent.
    */
-  timezone: string;
+  timezone?: string;
   /**
    * Hierarchical level of the region in the analysis.
    */
@@ -4595,7 +4580,8 @@ export type AreaAnalyticsFeatureProperties = {
     tiles: AreaAnalyticsTileEntry[];
   };
   /**
-   * Detected anomalies keyed by metric, if anomaly detection was performed.
+   * Detected anomalies keyed by metric. Empty for `trafficAreaAnalytics`: the service detects anomalies only over 35
+   * days or more, beyond a request's 31-day limit.
    */
   anomalies?: Partial<Record<AreaAnalyticsMetricKey, AreaAnalyticsAnomaly[]>>;
 };
@@ -4621,11 +4607,11 @@ export type AreaAnalyticsFeature = Omit<Feature<Polygon, AreaAnalyticsFeaturePro
  */
 export type AreaAnalyticsCollectionProperties = {
   /**
-   * Start of the analysis period.
+   * First analysed day, at midnight UTC: the range's `startDate`, or the earliest of the requested `days`.
    */
   startDate: Date;
   /**
-   * End of the analysis period.
+   * Last analysed day (inclusive), at midnight UTC: the range's `endDate`, or the latest of the requested `days`.
    */
   endDate: Date;
   /**
@@ -4803,7 +4789,7 @@ export declare const bboxFromCoordsArray: (coordinates: Position[] | undefined)
  * // Returns: [4.88, 52.36, 4.90, 52.38]
  *
  * // From a FeatureCollection (aggregates all features)
- * const places = await search({ key: 'key', query: 'coffee' });
+ * const places = await discoverPlaces({ key: 'key', query: 'coffee' });
  * const collectionBbox = bboxFromGeoJSON(places);
  * // Returns bbox encompassing all search results
  *
@@ -5369,17 +5355,17 @@ export declare const getRoutePlanningLocationType: (routePlanningLocation: Route
  */
 export declare const indexedMagnitudes: DelayMagnitude[];
 /**
- * Maps an `iconCategory` integer from the Incident Details API to a {@link TrafficIncidentCategory}.
+ * Maps an `iconCategory` integer from the traffic vector tiles to a {@link TrafficIncidentCategory}.
  * Integer values that do not correspond to a known category are mapped to `'other'`.
  *
- * @param iconCategory - Integer category code from the API response
+ * @param iconCategory - Integer category code from the tile
  * @returns The corresponding {@link TrafficIncidentCategory}
  *
  * @ignore
  */
 export declare const iconToTrafficIncidentCategory: (iconCategory: number) => TrafficIncidentCategory;
 /**
- * Maps a {@link TrafficIncidentCategory} string to the `iconCategory` integer used by the API.
+ * Maps a {@link TrafficIncidentCategory} string to the `iconCategory` integer used by the traffic vector tiles.
  * `'other'` and any unrecognised values map to `0`.
  *
  * @param category - The string category
@@ -5676,7 +5662,6 @@ export type RetryConfig = {
  * ```typescript
  * const config: GlobalConfig = {
  *   apiKey: 'your-api-key',
- *   apiVersion: 1,
  *   commonBaseURL: 'https://api.tomtom.com',
  *   language: 'en-US',
  *   displayUnits: {
@@ -5703,27 +5688,6 @@ export type GlobalConfig = {
    * * If provided, then the API key parameter will be ignored.
    * @experimental
    */
-  /**
-   * API version number for service endpoints.
-   *
-   * Each service may have its own default version. Consult the specific
-   * service documentation for available versions.
-   *
-   * @default 1 (but each service can override)
-   */
-  apiVersion: number;
-  /**
-   * Request identifier for tracing and support.
-   *
-   * Must match the pattern: `^[a-zA-Z0-9-]{1,100}$`
-   *
-   * Recommended format is UUID (e.g., `9ac68072-c7a4-11e8-a8d5-f2801f1b9fd1`).
-   * When specified, it's included in the `Tracking-ID` response header.
-   * This is solely for support purposes and does not involve user tracking.
-   *
-   * @see {@link https://docs.tomtom.com/search-api/documentation/search-service/fuzzy-search#trackingid-response | Tracking-ID documentation}
-   */
-  trackingId?: string;
   /**
    * Language code for SDK services and map content.
    *
@@ -5737,12 +5701,14 @@ export type GlobalConfig = {
    */
   language?: Language;
   /**
-   * Base URL for all TomTom API services.
+   * Base URL of every TomTom request: service calls, and the style, tile, sprite and glyph URLs the map fetches.
    *
-   * Individual services can override this with their own base URLs.
-   * Typically only changed for testing or enterprise deployments.
+   * Change it only to route those requests through a proxy of your own. Leaving `apiKey` unset too
+   * switches the SDK to proxy-credentials mode, where no key leaves the browser and requests carry the proxy's
+   * session cookie.
    *
    * @default "https://api.tomtom.com"
+   * @see [Proxying your API calls](https://docs.tomtom.com/maps-sdk-js/guides/security/proxying-api-calls)
    */
   commonBaseURL: string;
   /**
@@ -5763,6 +5729,20 @@ export type GlobalConfig = {
    */
   retry?: RetryConfig;
 };
+/**
+ * {@link GlobalConfig} plus the options the SDK honours but keeps off the public types.
+ *
+ * `put` and every service call still accept them at runtime; only {@link mergeFromGlobal} types them.
+ * @ignore
+ */
+export type InternalGlobalConfig = GlobalConfig & {
+  /**
+   * API version for service endpoints. Services that need another one pin it themselves.
+   *
+   * @default 1
+   */
+  apiVersion: number;
+};
 /**
  * Default base URL for TomTom APIs. A `commonBaseURL` other than this signals a
  * proxy or custom backend.
@@ -5859,7 +5839,7 @@ export declare class TomTomConfig {
  * Merges the global configuration into the given one, with the latter having priority.
  * @ignore
  */
-export declare const mergeFromGlobal: <T extends Partial<GlobalConfig>>(givenConfig?: T) => GlobalConfig & T;
+export declare const mergeFromGlobal: <T extends Partial<InternalGlobalConfig>>(givenConfig?: T) => InternalGlobalConfig & T;
 /**
  * Whether the SDK is configured for a credentials proxy such as the demos proxy
  * — no `apiKey` (the
@@ -5885,4 +5865,4 @@ export declare const mergeFromGlobal: <T extends Partial<GlobalConfig>>(givenCon
  */
 export declare const isProxyCredentialsMode: (config?: Partial<Pick<GlobalConfig, "apiKey" | "commonBaseURL">>) => boolean;
 //#endregion
-export type { Anything, BBox, ChargingAvailabilityDataSource, ChargingPark, ChargingParkWithAvailability, ChargingPointAvailability, ChargingStationsAvailability, CombustionSummary, ConnectorAvailability, ConnectorCount, DrivingSide, EVChargingStationWithAvailabilityPlaceProps, ElectricSummary, FeatureCollectionWithProperties, Fuel, GeometryDataSource, GetPositionEntryPointOption, GetPositionOptions, Guidance, HasBBox, HasConnector, HasCount, HasLngLat, Instruction, Landmark, Language, LegSummary, Maneuver, ManeuverAngle, ManeuverView, Moment, OpeningHours, OpeningHoursMode, OptionalBBox, POI, PathLike, PlaceDataSources, PoiDetailsDataSource, PolygonFeature, PolygonFeatures, RelatedPOI, RoadInformation, RoadInformationProperty, RoadShield, RoadShieldReference, RoundaboutType, RoutePathPoint, RoutePlanningLocation, RoutePlanningLocationType, RouteSummary, SideRoad, SideRoadSide, Signpost, SummaryBase, SummaryWithConsumption, TextWithPhonetics, TimeRange, TimeZone, TollPaymentType, TomTomAPIHeaders, TomTomHeaders, Waypoint, WaypointLike, WaypointProps, Waypoints, languages };
+export type { Anything, BBox, ChargingAvailabilityDataSource, ChargingPark, ChargingParkWithAvailability, ChargingPointAvailability, ChargingStationsAvailability, CombustionSummary, ConnectorAvailability, ConnectorCount, DrivingSide, EVChargingStationWithAvailabilityPlaceProps, ElectricSummary, FeatureCollectionWithProperties, Fuel, GeometryDataSource, GetPositionEntryPointOption, GetPositionOptions, Guidance, HasBBox, HasConnector, HasCount, HasLngLat, Instruction, InstructionText, Landmark, Language, LegSummary, Maneuver, ManeuverAngle, ManeuverView, Moment, OpeningHours, OpeningHoursMode, OptionalBBox, POI, PathLike, PlaceDataSources, PoiDetailsDataSource, PolygonFeature, PolygonFeatures, RelatedPOI, RoadInformation, RoadInformationProperty, RoadShield, RoadShieldReference, RoundaboutType, RoutePathPoint, RoutePlanningLocation, RoutePlanningLocationType, RouteSummary, SideRoad, SideRoadSide, Signpost, SummaryBase, SummaryWithConsumption, TimeRange, TimeZone, TollPaymentType, TomTomAPIHeaders, TomTomHeaders, Waypoint, WaypointLike, WaypointProps, Waypoints, languages };