/** * @fileoverview Place-related types for locations with weather forecasts. * @module meteo-lt-sdk/types/places */ import type { Coordinates } from './coordinates.js'; /** * Summary information for a place in the places list. * Returned by GET /places endpoint. */ export interface PlaceSummary { /** Unique place code used in API requests (e.g., 'vilnius') */ readonly code: string; /** Human-readable place name */ readonly name: string; /** Administrative division the place belongs to */ readonly administrativeDivision: string; /** ISO 3166-1 alpha-2 country code (e.g., 'LT') */ readonly countryCode: string; /** Geographic coordinates in WGS84 */ readonly coordinates: Coordinates; } /** * Detailed information for a single place. * Returned by GET /places/{place-code} endpoint. */ export interface PlaceDetails extends PlaceSummary { /** Full country name */ readonly country: string; } /** * Available forecast types. * Currently only 'long-term' is supported by the API. */ export type ForecastType = 'long-term'; /** * Information about an available forecast type. */ export interface ForecastTypeInfo { /** Forecast type identifier */ readonly type: ForecastType; /** Human-readable description of the forecast type */ readonly description: string; } /** * Response containing place details and available forecast types. * Returned by GET /places/{place-code}/forecasts endpoint. */ export interface PlaceForecastTypes { /** Place information */ readonly place: PlaceDetails; /** List of available forecast types for this place */ readonly forecastTypes: readonly ForecastTypeInfo[]; } //# sourceMappingURL=places.d.ts.map