1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
/* MaplyWMSTileSource.h
* WhirlyGlobe-MaplyComponent
*
* Created by Steve Gifford on 7/25/13.
* Copyright 2011-2022 mousebird consulting
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#import <WhirlyGlobeMaplyComponent/MaplyTileSourceNew.h>
#import <WhirlyGlobeMaplyComponent/MaplyCoordinateSystem.h>
/** A bounding box for a specific CRS in that coordinate
system. This is part of the Web Map Server parser.
*/
@interface MaplyWMSLayerBoundingBox : NSObject
/// Coordinate Reference System
@property (nonatomic,strong,nullable) NSString *crs;
/// Left side of the bounding box
@property (nonatomic) double minx;
/// Bottom of the bounding box
@property (nonatomic) double miny;
/// Right side of the bounding box
@property (nonatomic) double maxx;
/// Top of the bounding box
@property (nonatomic) double maxy;
/// Generate the coordinate system, if we can
- (nullable MaplyCoordinateSystem *)buildCoordinateSystem;
@end
/** Style of a WMS layer as returned by GetCapabilities.
This is part of the Web Map Service parser.
*/
@interface MaplyWMSStyle : NSObject
/// The name as returned by the service
@property (nonatomic,strong,nullable) NSString *name;
/// The title as returned by the service
@property (nonatomic,strong,nullable) NSString *title;
@end
/** Description of a WMS layer as returned by a GetCapabilities call.
This is part of the Web Map Service parser.
*/
@interface MaplyWMSLayer : NSObject
/// The name as returned by the service
@property (nonatomic,strong,nullable) NSString *name;
/// The title as returned by the service
@property (nonatomic,strong,nullable) NSString *title;
/// The abstract as returned by the service
@property (nonatomic,strong,nullable) NSString *abstract;
/// Coordinate reference systems supported by the layer
@property (nonatomic,strong,nullable) NSArray *coordRefSystems;
/// Styles we can choose
@property (nonatomic,strong,nullable) NSArray *styles;
/// Bounding boxes for zero or more of the CRS'
@property (nonatomic,strong,nullable) NSArray *boundingBoxes;
/// Lower left corner in longitude/latitude
@property (nonatomic) MaplyCoordinate ll;
/// Upper right corner in longitude/latitude
@property (nonatomic) MaplyCoordinate ur;
/// Try to build a coordinate system we understand
- (nullable MaplyCoordinateSystem *)buildCoordSystem;
/// Find the style with the given name
- (nullable MaplyWMSStyle *)findStyle:(NSString *__nonnull)styleName;
@end
@class DDXMLDocument;
/** Encapsulates the capabilities coming back from a WMS server.
We can query this to see what layers and coordinate systems are available.
Part of the Web Map Service parser.
*/
@interface MaplyWMSCapabilities : NSObject
/// We can fetch the capabilities from this URL
+ (nonnull NSString *)CapabilitiesURLFor:(NSString *__nonnull)baseURL;
/// The name as returned by the service
@property (nonatomic,strong,nullable) NSString *name;
/// The title as returned by the service
@property (nonatomic,strong,nullable) NSString *title;
/// Available formats (strings)
@property (nonatomic,strong,nullable) NSArray *formats;
/// Layers we can fetch from
@property (nonatomic,strong,nullable) NSArray *layers;
/// This constructor will initialize with an XML document that
/// we've fetched from the server, presumably.
- (nullable instancetype)initWithXML:(DDXMLDocument *__nonnull)xmlDoc;
/// Look for a layer with the given name.
- (nullable MaplyWMSLayer *)findLayer:(NSString *__nonnull)name;
@end
/** This is a MaplyTileSource that works with a remote
Web Map Service implementation. WMS is not the most
efficient way to access remote image data, but there
are still a few places that use it.
*/
@interface MaplyWMSTileSource : NSObject<MaplyTileInfoNew>
/// Base URL for the Map Service
@property (nonatomic,strong,nullable) NSString *baseURL;
/// Capabilities describing the service
@property (nonatomic,strong,nullable) MaplyWMSCapabilities *capabilities;
/// Image type to request
@property (nonatomic,strong,nullable) NSString *imageType;
/// Layer we're grabbing
@property (nonatomic,strong,nonnull) MaplyWMSLayer *layer;
/// Optional style we're using
@property (nonatomic,strong,nonnull) MaplyWMSStyle *style;
/// Minimum zoom level we'll expect
@property (nonatomic,readonly) int minZoom;
/// Maximum zoom level we'll expect
@property (nonatomic,readonly) int maxZoom;
/// Tile size provided to caller
@property (nonatomic,readonly) int tileSize;
/// If set we'll ask for a transparent background from the server
@property (nonatomic) bool transparent;
/// Coordinate system (used to build URLs)
@property (nonatomic,readonly,nonnull) MaplyCoordinateSystem *coordSys;
/// If set, we'll cache the images locally (a good idea with WMS)
@property (nonatomic,strong,nullable) NSString *cacheDir;
/** Initialize with the parameters the WMS server is going to want.
@param baseURL The main URL we'll use to construct queries.
@param cap The capabilities as parsed from the service.
@param layer The layer we'll access. There can be multiple and it's
up to you to pick one.
@param style The style variant of the layer we want. Again there can
be multiple and it's up to you to pick.
@param coordSys The coordinate system we're expecting to work in.
@param minZoom The min zoom level we want. Note that WMS doesn't handle
this directly. Our tile source just controls what areas it
asks for based on the overall extents and the zoom levels.
@param maxZoom The max zoom level we'll query.
*/
- (nullable instancetype)initWithBaseURL:(NSString *__nonnull)baseURL capabilities:(MaplyWMSCapabilities *__nullable)cap layer:(MaplyWMSLayer *__nonnull)layer style:(MaplyWMSStyle *__nonnull)style coordSys:(MaplyCoordinateSystem *__nonnull)coordSys minZoom:(int)minZoom maxZoom:(int)maxZoom tileSize:(int)tileSize;
@end
|
