blob: dc92e652e8ba3ea225028395d9ebf482361fcd89 (
plain)
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
|
#import <Foundation/Foundation.h>
#import "MGLFoundation.h"
#import "MGLTypes.h"
NS_ASSUME_NONNULL_BEGIN
FOUNDATION_EXTERN MGL_EXPORT MGLExceptionName const MGLInvalidStyleSourceException;
/**
`MGLSource` is an abstract base class for map content sources. A map content
source supplies content to be shown on the map. A source is added to an
`MGLStyle` object along with an `MGLForegroundStyleLayer` object. The
foreground style layer defines the appearance of any content supplied by the
source.
Each source defined by the style JSON file is represented at runtime by an
`MGLSource` object that you can use to refine the map’s content. You can also
add and remove sources dynamically using methods such as
`-[MGLStyle addSource:]` and `-[MGLStyle sourceWithIdentifier:]`.
Create instances of `MGLShapeSource`, `MGLComputedShapeSource`,
`MGLImageSource`, and the concrete subclasses of `MGLTileSource`
(`MGLVectorTileSource` and `MGLRasterTileSource`) in order to use `MGLSource`’s
properties and methods. Do not create instances of `MGLSource` directly, and do
not create your own subclasses of this class.
*/
MGL_EXPORT
@interface MGLSource : NSObject
#pragma mark Initializing a Source
- (instancetype)init __attribute__((unavailable("Use -initWithIdentifier: instead.")));
/**
Returns a source initialized with an identifier.
After initializing and configuring the source, add it to a map view’s style
using the `-[MGLStyle addSource:]` method.
@param identifier A string that uniquely identifies the source in the style to
which it is added.
@return An initialized source.
*/
- (instancetype)initWithIdentifier:(NSString *)identifier;
#pragma mark Identifying a Source
/**
A string that uniquely identifies the source in the style to which it is added.
*/
@property (nonatomic, copy) NSString *identifier;
@end
NS_ASSUME_NONNULL_END
|
