@progress/kendo-angular-map 19.1.2-develop.2 → 19.1.2-develop.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/directives.d.ts +2 -2
  2. package/esm2022/directives.mjs +2 -2
  3. package/esm2022/events/before-reset-event.mjs +2 -1
  4. package/esm2022/events/map-click-event.mjs +3 -2
  5. package/esm2022/events/marker-activate-event.mjs +2 -1
  6. package/esm2022/events/marker-click-event.mjs +2 -1
  7. package/esm2022/events/marker-created-event.mjs +3 -2
  8. package/esm2022/events/pan-end-event.mjs +3 -2
  9. package/esm2022/events/pan-event.mjs +3 -2
  10. package/esm2022/events/reset-event.mjs +2 -1
  11. package/esm2022/events/shape-click-event.mjs +3 -2
  12. package/esm2022/events/shape-created-event.mjs +3 -2
  13. package/esm2022/events/shape-feature-created-event.mjs +4 -3
  14. package/esm2022/events/shape-mouse-enter-event.mjs +5 -4
  15. package/esm2022/events/shape-mouse-leave-event.mjs +5 -4
  16. package/esm2022/events/zoom-end-event.mjs +3 -2
  17. package/esm2022/events/zoom-start-event.mjs +4 -4
  18. package/esm2022/map/bubble-layer.component.mjs +33 -11
  19. package/esm2022/map/layers.component.mjs +20 -1
  20. package/esm2022/map/marker-layer.component.mjs +29 -9
  21. package/esm2022/map/shape-layer.component.mjs +22 -3
  22. package/esm2022/map/tile-layer.component.mjs +24 -6
  23. package/esm2022/map.component.mjs +70 -69
  24. package/esm2022/map.module.mjs +18 -18
  25. package/esm2022/package-metadata.mjs +2 -2
  26. package/esm2022/tooltip/bubble-tooltip-template.directive.mjs +21 -0
  27. package/esm2022/tooltip/bubble-tooltip.component.mjs +24 -1
  28. package/esm2022/tooltip/marker-tooltip-template.directive.mjs +21 -0
  29. package/esm2022/tooltip/marker-tooltip.component.mjs +24 -1
  30. package/esm2022/tooltip/shape-tooltip-template.directive.mjs +21 -0
  31. package/esm2022/tooltip/shape-tooltip.component.mjs +24 -1
  32. package/events/before-reset-event.d.ts +2 -1
  33. package/events/map-click-event.d.ts +3 -2
  34. package/events/marker-activate-event.d.ts +2 -1
  35. package/events/marker-click-event.d.ts +2 -1
  36. package/events/marker-created-event.d.ts +3 -2
  37. package/events/pan-end-event.d.ts +3 -2
  38. package/events/pan-event.d.ts +3 -2
  39. package/events/reset-event.d.ts +2 -1
  40. package/events/shape-click-event.d.ts +3 -2
  41. package/events/shape-created-event.d.ts +3 -2
  42. package/events/shape-feature-created-event.d.ts +4 -3
  43. package/events/shape-mouse-enter-event.d.ts +5 -4
  44. package/events/shape-mouse-leave-event.d.ts +5 -4
  45. package/events/zoom-end-event.d.ts +3 -2
  46. package/events/zoom-start-event.d.ts +4 -4
  47. package/fesm2022/progress-kendo-angular-map.mjs +402 -157
  48. package/map/bubble-layer.component.d.ts +33 -11
  49. package/map/layers.component.d.ts +20 -1
  50. package/map/marker-layer.component.d.ts +29 -9
  51. package/map/shape-layer.component.d.ts +22 -3
  52. package/map/tile-layer.component.d.ts +24 -6
  53. package/map.component.d.ts +70 -69
  54. package/map.module.d.ts +18 -18
  55. package/package.json +7 -7
  56. package/schematics/ngAdd/index.js +1 -1
  57. package/tooltip/bubble-tooltip-template.directive.d.ts +21 -0
  58. package/tooltip/bubble-tooltip.component.d.ts +24 -1
  59. package/tooltip/marker-tooltip-template.directive.d.ts +21 -0
  60. package/tooltip/marker-tooltip.component.d.ts +24 -1
  61. package/tooltip/popup-settings.interface.d.ts +3 -3
  62. package/tooltip/shape-tooltip-template.directive.d.ts +21 -0
  63. package/tooltip/shape-tooltip.component.d.ts +24 -1
@@ -10,44 +10,66 @@ import { ConfigurationService } from '../common/configuration.service';
10
10
  import { LayerComponent } from './layer.component';
11
11
  import * as i0 from "@angular/core";
12
12
  /**
13
- * A vector shape layer for bubble maps. [See example](slug:bubble_layers_map).
13
+ * Represents the Kendo UI BubbleLayer component for Angular. Displays data as bubbles on vector shape layers for bubble maps.
14
+ *
15
+ * @example
16
+ * ```typescript
17
+ * @Component({
18
+ * selector: 'my-app',
19
+ * template: `
20
+ * <kendo-map>
21
+ * <kendo-map-bubble-layer
22
+ * [data]="bubbleData"
23
+ * locationField="location"
24
+ * valueField="population"
25
+ * [maxSize]="50"
26
+ * [minSize]="10">
27
+ * </kendo-map-bubble-layer>
28
+ * </kendo-map>
29
+ * `
30
+ * })
31
+ * export class AppComponent {
32
+ * public bubbleData = [
33
+ * { location: [40.7128, -74.0060], population: 8000000 }
34
+ * ];
35
+ * }
36
+ * ```
14
37
  */
15
38
  export declare class BubbleLayerComponent extends LayerComponent implements BubbleLayerOptions {
16
39
  protected configurationService: ConfigurationService;
17
40
  protected collectionService: CollectionService;
18
41
  protected sanitizer: DomSanitizer;
19
42
  /**
20
- * The array of data items for this layer.
43
+ * Sets the array of data items for this layer.
21
44
  */
22
45
  data?: any[];
23
46
  /**
24
- * The data item field which contains the symbol location.
25
- *
26
- * The field should be an array with two numbers - latitude and longitude in decimal degrees.
47
+ * Sets the data item field which contains the symbol location.
48
+ * The field should be an array with two numbers &mdash; latitude and longitude in decimal degrees.
27
49
  */
28
50
  locationField?: string;
29
51
  /**
30
- * The value field for the symbols used to determine their relative size.
52
+ * Sets the value field for the symbols used to determine their relative size.
31
53
  * The data item field should be a number.
32
54
  */
33
55
  valueField?: string;
34
56
  /**
35
- * The symbol to use for bubble layers.
57
+ * Sets the symbol to use for bubble layers.
36
58
  */
37
59
  symbol?: BubbleLayerSymbol;
38
60
  /**
39
- * The default style for symbols.
61
+ * Sets the default style for symbols.
40
62
  */
41
63
  style?: ShapeOptions;
42
64
  /**
43
- * The maximum symbol size for bubble layer symbols.
65
+ * Sets the maximum symbol size for bubble layer symbols.
44
66
  *
45
67
  * @default 100
46
68
  */
47
69
  maxSize?: number;
48
70
  /**
49
- * The minimum symbol size for bubble layer symbols.
50
- * Setting non-zero value will distort symbol area to value ratio.
71
+ * Sets the minimum symbol size for bubble layer symbols.
72
+ * Setting a non-zero value will distort the symbol area to value ratio.
51
73
  *
52
74
  * @default 0
53
75
  */
@@ -7,7 +7,26 @@ import { CollectionService } from '../common/collection.service';
7
7
  import { ConfigurationService } from '../common/configuration.service';
8
8
  import * as i0 from "@angular/core";
9
9
  /**
10
- * A collection of one or more layers.
10
+ * Represents the Kendo UI Layers component for Angular. Contains a collection of one or more map layers.
11
+ *
12
+ * @example
13
+ * ```typescript
14
+ * @Component({
15
+ * selector: 'my-app',
16
+ * template: `
17
+ * <kendo-map>
18
+ * <kendo-map-layers>
19
+ * <kendo-map-tile-layer [urlTemplate]="tileUrl"></kendo-map-tile-layer>
20
+ * <kendo-map-shape-layer [data]="shapeData"></kendo-map-shape-layer>
21
+ * </kendo-map-layers>
22
+ * </kendo-map>
23
+ * `
24
+ * })
25
+ * export class AppComponent {
26
+ * public tileUrl = (args: any) => `https://tile.openstreetmap.org/${args.z}/${args.x}/${args.y}.png`;
27
+ * public shapeData = [];
28
+ * }
29
+ * ```
11
30
  */
12
31
  export declare class LayersComponent extends CollectionComponent {
13
32
  protected configurationService: ConfigurationService;
@@ -9,30 +9,50 @@ import { ConfigurationService } from '../common/configuration.service';
9
9
  import { LayerComponent } from './layer.component';
10
10
  import * as i0 from "@angular/core";
11
11
  /**
12
- * A vector shape layer for bubble maps. [See example](slug:marker_layers_map).
12
+ * Represents the Kendo UI MarkerLayer component for Angular. Displays data as markers on vector shape layers for marker maps.
13
+ *
14
+ * @example
15
+ * ```typescript
16
+ * @Component({
17
+ * selector: 'my-app',
18
+ * template: `
19
+ * <kendo-map>
20
+ * <kendo-map-marker-layer
21
+ * [data]="markerData"
22
+ * locationField="location"
23
+ * titleField="title"
24
+ * shape="pin">
25
+ * </kendo-map-marker-layer>
26
+ * </kendo-map>
27
+ * `
28
+ * })
29
+ * export class AppComponent {
30
+ * public markerData = [
31
+ * { location: [40.7128, -74.0060], title: "New York" }
32
+ * ];
33
+ * }
34
+ * ```
13
35
  */
14
36
  export declare class MarkerLayerComponent extends LayerComponent implements MarkerLayerOptions {
15
37
  protected configurationService: ConfigurationService;
16
38
  protected collectionService: CollectionService;
17
39
  protected sanitizer: DomSanitizer;
18
40
  /**
19
- * The array of data items for this layer.
41
+ * Sets the array of data items for this layer.
20
42
  */
21
43
  data?: any[];
22
44
  /**
23
- * The data item field which contains the marker location.
24
- *
25
- * The field should be an array with two numbers - latitude and longitude in decimal degrees.
45
+ * Sets the data item field which contains the marker location.
46
+ * The field should be an array with two numbers &mdash; latitude and longitude in decimal degrees.
26
47
  */
27
48
  locationField?: string;
28
49
  /**
29
- * The data item field which contains the marker title.
50
+ * Sets the data item field which contains the marker title.
30
51
  */
31
52
  titleField?: string;
32
53
  /**
33
- * The default marker shape for data-bound markers. Supported marker shapes are "pinTarget and "pin".
34
- *
35
- * Marker shapes are implemented as CSS classes on the marker element (`span.k-marker`). For example "pinTarget" is rendered as `k-marker-pin-target`.
54
+ * Sets the default marker shape for data-bound markers. Supported marker shapes are `pinTarget` and `pin`.
55
+ * Marker shapes are implemented as CSS classes on the marker element (`span.k-marker`). For example `pinTarget` is rendered as `k-marker-pin-target`.
36
56
  */
37
57
  shape?: string | 'pinTarget' | 'pin';
38
58
  constructor(configurationService: ConfigurationService, collectionService: CollectionService, sanitizer: DomSanitizer);
@@ -10,18 +10,37 @@ import { ConfigurationService } from '../common/configuration.service';
10
10
  import { LayerComponent } from './layer.component';
11
11
  import * as i0 from "@angular/core";
12
12
  /**
13
- * Defines a vector shape layer bound to GeoJSON data. [See example](slug:shape_layers_map).
13
+ * Represents the Kendo UI ShapeLayer component for Angular. Defines a vector shape layer bound to GeoJSON data.
14
+ *
15
+ * @example
16
+ * ```typescript
17
+ * @Component({
18
+ * selector: 'my-app',
19
+ * template: `
20
+ * <kendo-map>
21
+ * <kendo-map-shape-layer
22
+ * [data]="geoJsonData"
23
+ * [style]="shapeStyle">
24
+ * </kendo-map-shape-layer>
25
+ * </kendo-map>
26
+ * `
27
+ * })
28
+ * export class AppComponent {
29
+ * public geoJsonData = { type: "FeatureCollection", features: [] };
30
+ * public shapeStyle = { fill: { color: "#007acc" }, stroke: { color: "#ffffff" } };
31
+ * }
32
+ * ```
14
33
  */
15
34
  export declare class ShapeLayerComponent extends LayerComponent implements ShapeLayerOptions {
16
35
  protected configurationService: ConfigurationService;
17
36
  protected collectionService: CollectionService;
18
37
  protected sanitizer: DomSanitizer;
19
38
  /**
20
- * The array of data items for this layer.
39
+ * Sets the array of data items for this layer.
21
40
  */
22
41
  data?: any;
23
42
  /**
24
- * The default style for shapes.
43
+ * Sets the default style for shapes.
25
44
  */
26
45
  style?: ShapeOptions;
27
46
  constructor(configurationService: ConfigurationService, collectionService: CollectionService, sanitizer: DomSanitizer);
@@ -9,26 +9,44 @@ import { ConfigurationService } from '../common/configuration.service';
9
9
  import { LayerComponent } from './layer.component';
10
10
  import * as i0 from "@angular/core";
11
11
  /**
12
- * Defines a vector shape layer bound to GeoJSON data. [See example](slug:tile_layers_map).
12
+ * Represents the Kendo UI TileLayer component for Angular. Displays raster map tiles from various sources.
13
+ *
14
+ * @example
15
+ * ```typescript
16
+ * @Component({
17
+ * selector: 'my-app',
18
+ * template: `
19
+ * <kendo-map>
20
+ * <kendo-map-tile-layer
21
+ * [urlTemplate]="tileUrlTemplate"
22
+ * [subdomains]="['a', 'b', 'c']"
23
+ * [tileSize]="256">
24
+ * </kendo-map-tile-layer>
25
+ * </kendo-map>
26
+ * `
27
+ * })
28
+ * export class AppComponent {
29
+ * public tileUrlTemplate = (args: any) => `https://${args.subdomain}.tile.openstreetmap.org/${args.z}/${args.x}/${args.y}.png`;
30
+ * }
31
+ * ```
13
32
  */
14
33
  export declare class TileLayerComponent extends LayerComponent implements TileLayerOptions {
15
34
  protected configurationService: ConfigurationService;
16
35
  protected collectionService: CollectionService;
17
36
  protected sanitizer: DomSanitizer;
18
37
  /**
19
- * The size of the image tile in pixels.
38
+ * Sets the size of the image tile in pixels.
20
39
  *
21
40
  * @default 256
22
41
  */
23
42
  tileSize: number;
24
43
  /**
25
- * A list of subdomains to use for loading tiles.
26
- *
27
- * Alternating between different subdomains allows more requests to be executed in parallel.
44
+ * Sets a list of subdomains to use for loading tiles.
45
+ * Alternating between different subdomains allows more requests to execute in parallel.
28
46
  */
29
47
  subdomains: string[];
30
48
  /**
31
- * A function that returns an image URL for each tile position.
49
+ * Sets a function that returns an image URL for each tile position.
32
50
  */
33
51
  urlTemplate: (args: TileUrlTemplateArgs) => string;
34
52
  constructor(configurationService: ConfigurationService, collectionService: CollectionService, sanitizer: DomSanitizer);
@@ -18,11 +18,14 @@ import * as i0 from "@angular/core";
18
18
  /**
19
19
  * Represents the [Kendo UI Map component for Angular]({% slug overview_map %}).
20
20
  *
21
+ * Use this component to display interactive maps with markers, layers, and controls.
22
+ * Configure zoom levels, center coordinates, and user interactions like panning and zooming.
23
+ *
21
24
  * @example
22
25
  * ```ts
23
26
  * import { Component } from '@angular/core';
24
27
  *
25
- * _@Component({
28
+ * @Component({
26
29
  * selector: 'my-app',
27
30
  * template: `
28
31
  * <kendo-map [center]="center" [zoom]="15">
@@ -51,7 +54,6 @@ import * as i0 from "@angular/core";
51
54
  * center = [30.2675, -97.7409];
52
55
  * markers = [{ latlng: [30.2675, -97.7409], name: "Zevo Toys" }];
53
56
  * }
54
- *
55
57
  * ```
56
58
  */
57
59
  export declare class MapComponent implements AfterViewInit, AfterViewChecked, OnChanges, OnDestroy {
@@ -66,18 +68,16 @@ export declare class MapComponent implements AfterViewInit, AfterViewChecked, On
66
68
  /**
67
69
  * Limits the automatic resizing of the Map. Sets the maximum number of times per second
68
70
  * that the component redraws its content when the size of its container changes.
69
- * Defaults to `10`. To disable the automatic resizing, set it to `0`.
71
+ * To disable the automatic resizing, set it to `0`.
72
+ *
73
+ * @default 10
70
74
  *
71
75
  * @example
72
76
  * ```ts
73
- * _@Component({
77
+ * @Component({
74
78
  * selector: 'my-app',
75
79
  * template: `
76
80
  * <kendo-map [resizeRateLimit]="2">
77
- * <!-- ^^^^^^^^^^^^^^^^^^^^^^
78
- * Will update the size of the Map up to two times a second.
79
- * Resize the example pane or window to try it out.
80
- * -->
81
81
  * </kendo-map>
82
82
  * `
83
83
  * })
@@ -87,11 +87,12 @@ export declare class MapComponent implements AfterViewInit, AfterViewChecked, On
87
87
  */
88
88
  resizeRateLimit: number;
89
89
  /**
90
- * The map center. Coordinates are listed as `[Latitude, Longitude]`.
90
+ * Specifies the map center coordinates.
91
+ * Provide coordinates as `[Latitude, Longitude]`.
91
92
  */
92
93
  center: number[];
93
94
  /**
94
- * The configuration of built-in map controls.
95
+ * Specifies the configuration for built-in map controls.
95
96
  */
96
97
  controls: MapControls;
97
98
  /**
@@ -129,101 +130,98 @@ export declare class MapComponent implements AfterViewInit, AfterViewChecked, On
129
130
  */
130
131
  wraparound: boolean;
131
132
  /**
132
- * The initial zoom level.
133
- *
134
- * Typical web maps use zoom levels from 0 (whole world) to 19 (sub-meter features).
135
- *
136
- * The map size is derived from the zoom level and minScale options: `size = (2 ^ zoom) * minSize`
137
- *
138
- * > Map zoom rounds floating point numbers. This is done so as the majority of web maps use the whole [`zoom levels`](https://wiki.openstreetmap.org/wiki/Zoom_levels) 0 through to 19.
133
+ * Specifies the initial zoom level.
134
+ * Use values from 0 (whole world) to 19 (sub-meter features).
135
+ * The map size derives from the zoom level and `minScale` options: `size = (2 ^ zoom) * minSize`.
136
+ * Map zoom rounds floating point numbers to use whole [`zoom levels`](https://wiki.openstreetmap.org/wiki/Zoom_levels) 0 through 19.
139
137
  *
140
138
  * @default 3
141
139
  */
142
140
  zoom: number;
143
141
  /**
144
- * Controls whether the map zoom level can be changed by the user.
142
+ * Determines whether users can change the map zoom level.
145
143
  *
146
144
  * @default true
147
145
  */
148
146
  zoomable: boolean;
149
147
  /**
150
- * Fired immediately before the map is reset. This event is typically used for cleanup by layer implementers.
148
+ * Fires immediately before the map resets. This event is typically used for cleanup by layer implementers.
151
149
  */
152
150
  beforeReset: EventEmitter<BeforeResetEvent>;
153
151
  /**
154
- * Fired when the user clicks on the map.
152
+ * Fires when the user clicks on the map.
155
153
  */
156
154
  mapClick: EventEmitter<MapClickEvent>;
157
155
  /**
158
- * Fired when a marker has been displayed and has a DOM element assigned.
156
+ * Fires when a marker appears on the map and its DOM element becomes available.
159
157
  */
160
158
  markerActivate: EventEmitter<MarkerActivateEvent>;
161
159
  /**
162
- * Fired when a marker has been clicked or tapped.
160
+ * Fires when the user clicks or taps a marker.
163
161
  */
164
162
  markerClick: EventEmitter<MarkerClickEvent>;
165
163
  /**
166
- * Fired when a marker has been created and is about to be displayed.
164
+ * Fires once the map has created a marker, and just before the map displays it.
167
165
  *
168
- * Cancelling the event will prevent the marker from being shown.
166
+ * Cancelling the event prevents displaying the marker.
169
167
  */
170
168
  markerCreated: EventEmitter<MarkerCreatedEvent>;
171
169
  /**
172
- * Fires after the map viewport has been moved.
170
+ * Fires after the map viewport completes panning.
173
171
  */
174
172
  panEnd: EventEmitter<PanEndEvent>;
175
173
  /**
176
- * Fired while the map viewport is being moved.
174
+ * Fires while the map viewport is being moved.
177
175
  */
178
176
  pan: EventEmitter<PanEvent>;
179
177
  /**
180
- * Fired when the map is reset.
178
+ * Fires when the map resets.
181
179
  *
182
180
  * This typically occurs on initial load and after a zoom/center change.
183
181
  */
184
182
  reset: EventEmitter<ResetEvent>;
185
183
  /**
186
- * Fired when a shape is clicked or tapped.
184
+ * Fires when a shape is clicked or tapped.
187
185
  */
188
186
  shapeClick: EventEmitter<ShapeClickEvent>;
189
187
  /**
190
- * Fired when a shape is created, but is not rendered yet.
188
+ * Fires when a shape is created, but is not rendered yet.
191
189
  */
192
190
  shapeCreated: EventEmitter<ShapeCreatedEvent>;
193
191
  /**
194
- * Fired when a [GeoJSON Feature](https://geojson.org/geojson-spec.html#feature-objects) is created on a shape layer.
192
+ * Fires when a [GeoJSON Feature](https://geojson.org/geojson-spec.html#feature-objects) is created on a shape layer.
195
193
  */
196
194
  shapeFeatureCreated: EventEmitter<ShapeFeatureCreatedEvent>;
197
195
  /**
198
- * Fired when the mouse enters a shape.
196
+ * Fires when the mouse enters a shape.
199
197
  *
200
198
  * > This event will fire reliably only for shapes that have set fill color.
201
199
  * > The opacity can still be set to 0 so the shapes appear to have no fill.
202
200
  */
203
201
  shapeMouseEnter: EventEmitter<ShapeMouseEnterEvent>;
204
202
  /**
205
- * Fired when the mouse leaves a shape.
203
+ * Fires when the mouse leaves a shape.
206
204
  *
207
205
  * > This event will fire reliably only for shapes that have set fill color.
208
206
  * > The opacity can still be set to 0 so the shapes appear to have no fill.
209
207
  */
210
208
  shapeMouseLeave: EventEmitter<ShapeMouseLeaveEvent>;
211
209
  /**
212
- * Fired when the map zoom level is about to change.
210
+ * Fires when the map zoom level is about to change.
213
211
  *
214
212
  * Cancelling the event will prevent the user action.
215
213
  */
216
214
  zoomStart: EventEmitter<ZoomStartEvent>;
217
215
  /**
218
- * Fired when the map zoom level has changed.
216
+ * Fires when the map zoom level changes.
219
217
  */
220
218
  zoomEnd: EventEmitter<ZoomEndEvent>;
221
219
  /**
222
- * Fired when the map center has been changed.
220
+ * Fires when the map center has been changed.
223
221
  */
224
222
  centerChange: EventEmitter<number[]>;
225
223
  /**
226
- * Fired when the map zoom level has been changed.
224
+ * Fires when the map zoom level has been changed.
227
225
  */
228
226
  zoomChange: EventEmitter<number>;
229
227
  tooltipInstance: TooltipPopupComponent;
@@ -247,7 +245,7 @@ export declare class MapComponent implements AfterViewInit, AfterViewChecked, On
247
245
  }): void;
248
246
  ngOnDestroy(): void;
249
247
  /**
250
- * The marker layers instances.
248
+ * Gets the marker layers instances.
251
249
  */
252
250
  get layers(): MapLayer[];
253
251
  /**
@@ -259,77 +257,80 @@ export declare class MapComponent implements AfterViewInit, AfterViewChecked, On
259
257
  */
260
258
  set extent(extent: Extent);
261
259
  /**
262
- * Detects the size of the container and redraws the Map.
263
- * Resizing is automatic unless you set the `resizeRateLimit` option to `0`.
260
+ * Detects the container size and redraws the Map.
261
+ * Resizing happens automatically unless you set `resizeRateLimit` to `0`.
264
262
  */
265
263
  resize(): void;
266
264
  /**
267
- * Retrieves the size of the visible portion of the map.
265
+ * Gets the size of the visible map area.
268
266
  *
269
- * @returns The size (width and height) of the visible portion of the map.
267
+ * @returns {Object} The width and height of the visible map area.
270
268
  */
271
269
  viewSize(): {
272
270
  width: number;
273
271
  height: number;
274
272
  };
275
273
  /**
276
- * Returns the event coordinates relative to the map element. Offset coordinates are not synchronized to a particular location on the map.
274
+ * Gets event coordinates relative to the map element.
275
+ * Offset coordinates do not sync to a specific map location.
277
276
  *
278
- * @param e The mouse event.
279
- * @returns The event coordinates relative to the map element.
277
+ * @param {any} e The mouse event.
278
+ * @returns {geometry.Point} The event coordinates relative to the map element.
280
279
  */
281
280
  eventOffset(e: any): geometry.Point;
282
281
  /**
283
- * Retrieves projected (layer) coordinates that correspond to this mouse event. Layer coordinates are absolute and change only when the zoom level is changed.
282
+ * Gets projected layer coordinates for this mouse event.
283
+ * Layer coordinates are absolute and change only when zoom level changes.
284
284
  *
285
- * @param e The mouse event.
286
- * @returns The projected (layer) coordinates that correspond to this event.
285
+ * @param {any} e The mouse event.
286
+ * @returns {geometry.Point} The projected layer coordinates for this event.
287
287
  */
288
288
  eventToLayer(e: any): geometry.Point;
289
289
  /**
290
- * Retrieves the geographic location that correspond to this mouse event.
290
+ * Gets the geographic location for this mouse event.
291
291
  *
292
- * @param e The mouse event.
293
- * @returns The geographic location that correspond to this mouse event.
292
+ * @param {any} e The mouse event.
293
+ * @returns {geometry.Point} The geographic location for this mouse event.
294
294
  */
295
295
  eventToLocation(e: any): geometry.Point;
296
296
  /**
297
- * Retrieves relative (view) coordinates that correspond to this mouse event. Layer elements positioned on these coordinates will appear under the mouse cursor.
298
- * View coordinates are no longer valid after a map reset.
297
+ * Gets relative view coordinates for this mouse event.
298
+ * Layer elements positioned on these coordinates appear under the mouse cursor.
299
+ * View coordinates become invalid after a map reset.
299
300
  *
300
- * @param e The mouse event.
301
- * @returns The relative (view) coordinates that correspond to this mouse event.
301
+ * @param {any} e The mouse event.
302
+ * @returns {geometry.Point} The relative view coordinates for this mouse event.
302
303
  */
303
304
  eventToView(e: any): geometry.Point;
304
305
  /**
305
- * Transforms layer (projected) coordinates to geographical location.
306
+ * Converts layer coordinates to geographic location.
306
307
  *
307
- * @param point The layer (projected) coordinates. An array argument is assumed to be in x, y order.
308
- * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
309
- * @returns The geographic location that corresponds to the layer coordinates.
308
+ * @param {geometry.Point | number[]} point The layer coordinates. Arrays use x, y order.
309
+ * @param {number} zoom Optional. Zoom level to use. Defaults to current zoom level.
310
+ * @returns {Location} The geographic location for the layer coordinates.
310
311
  */
311
312
  layerToLocation(point: geometry.Point | number[], zoom?: number): Location;
312
313
  /**
313
- * Returns the layer (projected) coordinates that correspond to a geographical location.
314
+ * Gets layer coordinates for a geographic location.
314
315
  *
315
- * @param location The geographic location. An array argument is assumed to be in [Latitude, Longitude] order.
316
- * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
317
- * @returns The layer (projected) coordinates.
316
+ * @param {Location | number[]} location The geographic location. Arrays use [Latitude, Longitude] order.
317
+ * @param {number} zoom Optional. Zoom level to use. Defaults to current zoom level.
318
+ * @returns {geometry.Point} The layer coordinates.
318
319
  */
319
320
  locationToLayer(location: Location | number[], zoom?: number): geometry.Point;
320
321
  /**
321
- * Returns the view (relative) coordinates that correspond to a geographical location.
322
+ * Gets view coordinates for a geographic location.
322
323
  *
323
- * @param location The geographic location. An array argument is assumed to be in [Latitude, Longitude] order.
324
- * @returns The view coordinates that correspond to a geographical location.
324
+ * @param {Location | number[]} location The geographic location. Arrays use [Latitude, Longitude] order.
325
+ * @returns {geometry.Point} The view coordinates for the geographic location.
325
326
  */
326
327
  locationToView(location: Location | number[]): geometry.Point;
327
328
  /**
328
- * Returns the geographical location that correspond to the view (relative) coordinates.
329
+ * Gets the geographic location for view coordinates.
329
330
  *
330
- * @param point The view coordinates. An array argument is assumed to be in x, y order.
331
- * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
332
- * @returns The geographic location that corresponds to the view coordinates.
331
+ * @param {geometry.Point | number[]} point The view coordinates. Arrays use x, y order.
332
+ * @param {number} zoom Optional. Zoom level to use. Defaults to current zoom level.
333
+ * @returns {Location} The geographic location for the view coordinates.
333
334
  */
334
335
  viewToLocation(point: geometry.Point | number[], zoom?: number): Location;
335
336
  /**
package/map.module.d.ts CHANGED
@@ -17,24 +17,24 @@ import * as i11 from "./tooltip/shape-tooltip-template.directive";
17
17
  import * as i12 from "./map/tile-layer.component";
18
18
  /**
19
19
  * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
20
- * definition for the Map component.
21
- * @example
22
- *
23
- * ```ts
24
- * import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
25
- * import { BrowserModule } from '@angular/platform-browser';
26
- * import { NgModule } from '@angular/core';
27
- * import { MapModule } from '@progress/kendo-angular-map';
28
- * import { AppComponent } from './app.component';
29
- *
30
- * @NgModule({
31
- * declarations: [AppComponent],
32
- * imports: [BrowserModule, BrowserAnimationsModule, MapModule],
33
- * bootstrap: [AppComponent]
34
- * })
35
- * export class AppModule {}
36
- *```
37
- */
20
+ * definition for the Map component.
21
+ *
22
+ * @example
23
+ * ```ts
24
+ * import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
25
+ * import { BrowserModule } from '@angular/platform-browser';
26
+ * import { NgModule } from '@angular/core';
27
+ * import { MapModule } from '@progress/kendo-angular-map';
28
+ * import { AppComponent } from './app.component';
29
+ *
30
+ * @NgModule({
31
+ * declarations: [AppComponent],
32
+ * imports: [BrowserModule, BrowserAnimationsModule, MapModule],
33
+ * bootstrap: [AppComponent]
34
+ * })
35
+ * export class AppModule {}
36
+ * ```
37
+ */
38
38
  export declare class MapModule {
39
39
  static ɵfac: i0.ɵɵFactoryDeclaration<MapModule, never>;
40
40
  static ɵmod: i0.ɵɵNgModuleDeclaration<MapModule, never, [typeof i1.BubbleLayerComponent, typeof i2.BubbleTooltipComponent, typeof i3.BubbleTooltipTemplateDirective, typeof i4.LayersComponent, typeof i5.MapComponent, typeof i6.MarkerLayerComponent, typeof i7.MarkerTooltipComponent, typeof i8.MarkerTooltipTemplateDirective, typeof i9.ShapeLayerComponent, typeof i10.ShapeTooltipComponent, typeof i11.ShapeTooltipTemplateDirective, typeof i12.TileLayerComponent], [typeof i1.BubbleLayerComponent, typeof i2.BubbleTooltipComponent, typeof i3.BubbleTooltipTemplateDirective, typeof i4.LayersComponent, typeof i5.MapComponent, typeof i6.MarkerLayerComponent, typeof i7.MarkerTooltipComponent, typeof i8.MarkerTooltipTemplateDirective, typeof i9.ShapeLayerComponent, typeof i10.ShapeTooltipComponent, typeof i11.ShapeTooltipTemplateDirective, typeof i12.TileLayerComponent]>;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@progress/kendo-angular-map",
3
- "version": "19.1.2-develop.2",
3
+ "version": "19.1.2-develop.3",
4
4
  "description": "Kendo UI Map for Angular",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "author": "Progress",
@@ -22,7 +22,7 @@
22
22
  "package": {
23
23
  "productName": "Kendo UI for Angular",
24
24
  "productCode": "KENDOUIANGULAR",
25
- "publishDate": 1749820745,
25
+ "publishDate": 1750152817,
26
26
  "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
27
27
  }
28
28
  },
@@ -33,15 +33,15 @@
33
33
  "@angular/platform-browser": "16 - 20",
34
34
  "@progress/kendo-drawing": "^1.21.0",
35
35
  "@progress/kendo-licensing": "^1.5.0",
36
- "@progress/kendo-angular-common": "19.1.2-develop.2",
37
- "@progress/kendo-angular-icons": "19.1.2-develop.2",
38
- "@progress/kendo-angular-l10n": "19.1.2-develop.2",
39
- "@progress/kendo-angular-popup": "19.1.2-develop.2",
36
+ "@progress/kendo-angular-common": "19.1.2-develop.3",
37
+ "@progress/kendo-angular-icons": "19.1.2-develop.3",
38
+ "@progress/kendo-angular-l10n": "19.1.2-develop.3",
39
+ "@progress/kendo-angular-popup": "19.1.2-develop.3",
40
40
  "rxjs": "^6.4.0 || ^7.0.0"
41
41
  },
42
42
  "dependencies": {
43
43
  "tslib": "^2.3.1",
44
- "@progress/kendo-angular-schematics": "19.1.2-develop.2",
44
+ "@progress/kendo-angular-schematics": "19.1.2-develop.3",
45
45
  "@progress/kendo-charts": "2.7.2"
46
46
  },
47
47
  "schematics": "./schematics/collection.json",