├── .gitignore
├── .npmignore
├── README.md
├── demo
    └── index.html
├── package.json
├── plugin.xml
├── screenshots
    ├── android
    │   └── android-marker-amsterdam.png
    └── ios
    │   ├── ios-location-benelux.png
    │   ├── ios-location-europe-dark-boxed.png
    │   └── ios-marker-amsterdam.png
├── src
    ├── android
    │   ├── Mapbox.java
    │   ├── mapbox.gradle
    │   └── res
    │   │   └── values
    │   │       └── mapboxstrings.xml
    └── ios
    │   ├── CDVMapbox.h
    │   ├── CDVMapbox.m
    │   ├── Headers
    │       ├── MGLAccountManager.h
    │       ├── MGLAnnotation.h
    │       ├── MGLAnnotationImage.h
    │       ├── MGLGeometry.h
    │       ├── MGLMapCamera.h
    │       ├── MGLMapView+IBAdditions.h
    │       ├── MGLMapView.h
    │       ├── MGLMultiPoint.h
    │       ├── MGLOverlay.h
    │       ├── MGLPointAnnotation.h
    │       ├── MGLPolygon.h
    │       ├── MGLPolyline.h
    │       ├── MGLShape.h
    │       ├── MGLStyle.h
    │       ├── MGLTypes.h
    │       ├── MGLUserLocation.h
    │       └── Mapbox.h
    │   └── libs
    │       ├── Mapbox.bundle
    │           ├── Compass.png
    │           ├── Compass@2x.png
    │           ├── Compass@3x.png
    │           ├── README
    │           ├── api_mapbox_com-digicert.der
    │           ├── api_mapbox_com-geotrust.der
    │           ├── default_marker.png
    │           ├── default_marker@2x.png
    │           ├── default_marker@3x.png
    │           ├── mapbox.png
    │           ├── mapbox@2x.png
    │           ├── mapbox@3x.png
    │           └── star_tilestream_net.der
    │       ├── Settings.bundle
    │           ├── Root.plist
    │           └── en.lproj
    │           │   └── Root.strings
    │       ├── libMapbox.a
    │       └── version.txt
├── typescript
    └── mapbox.d.ts
└── www
    └── Mapbox.js


/.gitignore:
--------------------------------------------------------------------------------
1 | .idea


--------------------------------------------------------------------------------
/.npmignore:
--------------------------------------------------------------------------------
1 | demo/
2 | screenshots/
3 | .*
4 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Mapbox Cordova Plugin
 2 | by [Telerik](https://www.telerik.com) / [Eddy Verbruggen](http://twitter.com/eddyverbruggen)
 3 | 
 4 | ## 0. Index
 5 | 
 6 | 1. [Description](#1-description)
 7 | 2. [Screenshots](#2-screenshots)
 8 | 3. [Installation](#3-installation)
 9 | 4. [Usage](#4-usage)
10 | 5. [License](#5-license)
11 | 
12 | ## 1. Description
13 | 
14 | Use Mapbox - an OpenGL powered vector-based native mapping solution - in your Cordova / PhoneGap app.
15 | 
16 | iOS and Android are fully supported.
17 | 
18 | ## 2. Screenshots
19 | 
20 | ### iOS
21 | 
22 | <img src="https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/master/screenshots/ios/ios-marker-amsterdam.png" width="235"/>&nbsp;
23 | <img src="https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/master/screenshots/ios/ios-location-benelux.png" width="235"/>&nbsp;
24 | <img src="https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/master/screenshots/ios/ios-location-europe-dark-boxed.png" width="235"/>
25 | 
26 | ### Android
27 | 
28 | <img src="https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/master/screenshots/android/android-marker-amsterdam.png" width="400"/>
29 | 
30 | 
31 | ## 3. Installation
32 | 
33 | npm (latest stable)
34 | ```
35 | $ cordova plugin add cordova-plugin-mapbox --variable ACCESS_TOKEN=your.access.token
36 | ```
37 | 
38 | Github master (lastest develop)
39 | ```
40 | $ cordova plugin add https://github.com/Telerik-Verified-Plugins/Mapbox --variable ACCESS_TOKEN=your.access.token
41 | ```
42 | 
43 | Mapbox.js is brought in automatically. There is no need to change or add anything in your html.
44 | 
45 | ## 4. Usage
46 | 
47 | [We've documented the Mapbox plugin API here.](http://plugins.telerik.com/cordova/plugin/mapbox)
48 | 
49 | For a quick demo, check the [demo code](demo/index.html) which shows all the tricks in the book.
50 | 
51 | ## 5. License
52 | 
53 | [The MIT License (MIT)](http://www.opensource.org/licenses/mit-license.html)
54 | 
55 | Permission is hereby granted, free of charge, to any person obtaining a copy
56 | of this software and associated documentation files (the "Software"), to deal
57 | in the Software without restriction, including without limitation the rights
58 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
59 | copies of the Software, and to permit persons to whom the Software is
60 | furnished to do so, subject to the following conditions:
61 | 
62 | The above copyright notice and this permission notice shall be included in
63 | all copies or substantial portions of the Software.
64 | 
65 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
66 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
67 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
68 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
69 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
70 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
71 | THE SOFTWARE.


--------------------------------------------------------------------------------
/demo/index.html:
--------------------------------------------------------------------------------
  1 | <!DOCTYPE html>
  2 | <html>
  3 | <head>
  4 |   <meta charset="utf-8"/>
  5 |   <meta name="format-detection" content="telephone=no"/>
  6 |   <meta name="msapplication-tap-highlight" content="no"/>
  7 |   <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width, height=device-height"/>
  8 |   <link rel="stylesheet" type="text/css" href="css/index.css"/>
  9 |   <title>Mapbox test</title>
 10 | </head>
 11 | <body>
 12 | <div class="app">
 13 |   <h1>Mapbox test</h1>
 14 | 
 15 |   <div id="deviceready" class="blink">
 16 |     <p class="event listening">Connecting to Device</p>
 17 |     <p class="event received">Device is Ready</p>
 18 |     <br/>
 19 |     <br/>
 20 |     <button onclick="showMap()">Show</button>
 21 |   </div>
 22 |   <div style="position:absolute; bottom:0; background-color: #eee">
 23 |     <button onclick="animateCamera()">Camera</button>
 24 |     <button onclick="addMarkers()">Markers</button>
 25 |     <button onclick="removeAllMarkers()">Remove All Markers</button>
 26 |     <!--button onclick="addGeoJSON()">Add GeoJSON</button-->
 27 |     <button onclick="addPolygon()">Poly</button>
 28 |     <button onclick="hideMap()">hide</button><br/><br/>
 29 |     <button onclick="getZoomLevel()">getZoom</button>
 30 |     <button onclick="zoomIn()">zoom +</button>
 31 |     <button onclick="zoomOut()">zoom -</button><br/><br/>
 32 |     <button onclick="setCenter()">set center</button>
 33 |     <button onclick="getCenter()">get center</button>
 34 |     <button onclick="setBounds()">set bounds</button>
 35 |     <button onclick="getBounds()">get bounds</button>
 36 |     <button onclick="setTilt()">set tilt</button>
 37 |     <button onclick="getTilt()">get tilt</button><br/><br/>
 38 |     <button onclick="screen2Coords({'x': window.innerWidth/2,'y': window.innerHeight/2})">ctr2coords</button>
 39 |     <button onclick="coords2Screen({'lat': 52.3732160,'lng': 4.8941680})">ctr2screen</button>
 40 |     <button onclick="hideMap()">hide</button>
 41 |   </div>
 42 | </div>
 43 | 
 44 | <script type="text/javascript" src="cordova.js"></script>
 45 | <script type="text/javascript" src="js/index.js"></script>
 46 | <script>
 47 |   var zoom = 10;
 48 | 
 49 |   function setCenter() {
 50 |     Mapbox.setCenter({
 51 |       'lat': 50.2222,
 52 |       'lng': 5.2344,
 53 |       'animated': true // default false
 54 |     });
 55 |   }
 56 | 
 57 |   function getCenter() {
 58 |     Mapbox.getCenter(function (c) {
 59 |       alert(JSON.stringify(c))
 60 |     });
 61 |   }
 62 | 
 63 |   function setBounds() {
 64 |     Mapbox.setBounds({
 65 |       'sw_lat': 50.2222,
 66 |       'sw_lng': 5.2344,
 67 |       'ne_lat': 30.2222,
 68 |       'ne_lng': 2.2344,
 69 |       'animated': true // default false
 70 |     });
 71 |   }
 72 | 
 73 |   function getBounds() {
 74 |     Mapbox.getCenter(function (c) {
 75 |       alert(JSON.stringify(c))
 76 |     });
 77 |   }
 78 | 
 79 |   function setTilt() {
 80 |     Mapbox.setTilt({
 81 |       pitch: 45,
 82 |       duration: 4500
 83 |     });
 84 |   }
 85 | 
 86 |   function getTilt() {
 87 |     Mapbox.getTilt(function (t) {
 88 |       alert(t)
 89 |     });
 90 |   }
 91 | 
 92 |   function getZoomLevel() {
 93 |     Mapbox.getZoomLevel(function (zl) {
 94 |       alert(zl)
 95 |     });
 96 |   }
 97 | 
 98 |   function zoomIn() {
 99 |     Mapbox.setZoomLevel({
100 |       'level': ++zoom,
101 |       'animated': true // default false
102 |     });
103 |   }
104 | 
105 |   function zoomOut() {
106 |     Mapbox.setZoomLevel({
107 |       'level': --zoom,
108 |       'animated': true // default false
109 |     });
110 |   }
111 | 
112 |   function showMap() {
113 |     Mapbox.show({
114 |               style: 'emerald',
115 |               margins: {
116 |                 'left': 0,
117 |                 'right': 0,
118 |                 'top': 0,
119 |                 'bottom': 160
120 |               },
121 |               center: {
122 |                 lat: 52.3702160,
123 |                 lng: 4.8951680
124 |               },
125 |               zoomLevel: zoom, // 0 (the entire world) to 20, default 10
126 |               showUserLocation: true, // default false
127 |               hideAttribution: true, // default false
128 |               hideLogo: true, // default false
129 |               hideCompass: false, // default false
130 |               disableRotation: false, // default false
131 |               disableScroll: false, // default false
132 |               disableTilt: false, // default false
133 |               disableZoom: false, // default false
134 |               disablePitch: false, // default false
135 |               markers: [
136 |                 {
137 |                   'lat': 52.3732160,
138 |                   'lng': 4.8941680,
139 |                   'title': 'Nice location',
140 |                   'subtitle': 'Really really nice location',
141 |                   'image': 'www/img/markers/hi.jpg' // TODO support this on a rainy day
142 |                 }
143 |               ]
144 |             },
145 |             function (result) {
146 |               console.log(JSON.stringify(result));
147 |               // let's add a callback for these markers - invoked when the callout is tapped (Android) or the (i) icon in the marker callout (iOS)
148 |               Mapbox.addMarkerCallback(function (selectedMarker) {
149 |                 alert("Marker selected: " + JSON.stringify(selectedMarker));
150 |               });
151 |               // let's add callbacks for region changing
152 |               //
153 |               // - invoked when the map is about to moved (animated or not).
154 |               Mapbox.onRegionWillChange(function(centerCoordinates) {
155 |                 console.log("Map will move from: ", centerCoordinates);
156 |               });
157 |               // - invoked at each tick (so 60 per second) when the map moves. So don't do any heavy computing here.
158 |               Mapbox.onRegionIsChanging(function(centerCoordinates){
159 |                 console.log("New map center is: ", centerCoordinates);
160 |               });
161 |               // - invoked after the map has moved (animated or not).
162 |               Mapbox.onRegionDidChange(function(centerCoordinates) {
163 |                 console.log("Map as finished to move to : ", centerCoordinates);
164 |               });
165 |             },
166 |             function (error) {
167 |               alert(error);
168 |             }
169 |     )
170 |   }
171 | 
172 |   function hideMap() {
173 |     Mapbox.hide({},
174 |             function (result) {
175 |               console.log(JSON.stringify(result));
176 |             },
177 |             function (error) {
178 |               alert(error);
179 |             }
180 |     )
181 |   }
182 | 
183 |   function addGeoJSON() {
184 |     Mapbox.addGeoJSON({
185 |       'url': 'https://gist.githubusercontent.com/tmcw/10307131/raw/21c0a20312a2833afeee3b46028c3ed0e9756d4c/map.geojson'
186 |     });
187 |   }
188 | 
189 |   function addPolygon() {
190 |     Mapbox.addPolygon({
191 |       points: [
192 |         {
193 |           'lat': 52.3832160,
194 |           'lng': 4.8991680
195 |         },
196 |         {
197 |           'lat': 52.3632160,
198 |           'lng': 4.9011680
199 |         },
200 |         {
201 |           'lat': 52.3932160,
202 |           'lng': 4.8911680
203 |         }
204 |       ]
205 |     });
206 |   }
207 | 
208 |   function animateCamera() {
209 |     Mapbox.animateCamera({
210 |       // Sets the center of the map to Maracanã
211 |       target: {
212 |         lat: 52.3632160,
213 |         lng: 4.9011680
214 |       },
215 |       zoom: 17, // Android, zoomLevel
216 |       altitude: 1000, // iOS, meters from the ground
217 |       bearing: 270, // Sets the orientation of the camera to look west
218 |       tilt: 40, // // Sets the tilt of the camera to 30 degrees
219 |       duration: 10 // in seconds
220 |     });
221 |   }
222 | 
223 |   function addMarkers() {
224 |     Mapbox.addMarkers([
225 |               {
226 |                 'lat': 52.3602160,
227 |                 'lng': 4.8891680,
228 |                 'title': 'One-line title here', // no popup unless set
229 |                 'subtitle': 'This text can span multiple lines on Android only. On iOS it\'s one line max.',
230 |                 'image': 'www/img/markers/hi.jpg' // TODO support this on a rainy day
231 |               },
232 |               {
233 |                 'lat': 52.3702160,
234 |                 'lng': 4.8911680,
235 |                 'title': 'Nu subtitle for this one' // iOS: no popup unless set, Android: an empty popup -- so please add something
236 |               }
237 |             ],
238 |             function (result) {
239 |               console.log(JSON.stringify(result));
240 |             },
241 |             function (error) {
242 |               alert(error)
243 |             }
244 |     )
245 |   }
246 | 
247 |   function removeAllMarkers() {
248 |     Mapbox.removeAllMarkers(
249 |       function (result) {
250 |         console.log(JSON.stringify(result));
251 |       },
252 |       function (error) {
253 |         alert(error)
254 |       }
255 |     )
256 |   }
257 | 
258 |   function coords2Screen(coords) {
259 |     Mapbox.convertCoordinate(coords,
260 |             function (point) {
261 |               alert("x:"+point.x+" - y:"+point.y);
262 |             },
263 |             function (error) {
264 |               alert(error)
265 |             })
266 |   }
267 | 
268 |   function screen2Coords(point){
269 |     Mapbox.convertPoint({
270 |               'x':point.x,
271 |               'y':point.y
272 |             },
273 |             function (latlng) {
274 |               alert("lat:"+latlng.lat+" - lng:"+latlng.lng);
275 |             },
276 |             function (error) {
277 |               alert(error)
278 |             })
279 |   }
280 | 
281 | </script>
282 | </body>
283 | </html>
284 | 


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "version": "1.2.3",
 3 |   "name": "cordova-plugin-mapbox",
 4 |   "cordova_name": "Mapbox",
 5 |   "description": "Need native maps? Look no further!",
 6 |   "license": "MIT",
 7 |   "repo": "https://github.com/Telerik-Verified-Plugins/Mapbox.git",
 8 |   "issue": "https://github.com/Telerik-Verified-Plugins/Mapbox/issues",
 9 |   "keywords": [
10 |     "Mapbox",
11 |     "Maps",
12 |     "Mapping",
13 |     "Native maps",
14 |     "ecosystem:cordova",
15 |     "cordova-android",
16 |     "cordova-ios"
17 |   ],
18 |   "platforms": [
19 |     "android",
20 |     "ios"
21 |   ],
22 |   "engines": [
23 |     {
24 |       "name": "cordova",
25 |       "version": ">=3.5.0"
26 |     }
27 |   ]
28 | }
29 | 


--------------------------------------------------------------------------------
/plugin.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
  3 |         xmlns:android="http://schemas.android.com/apk/res/android"
  4 |         id="cordova-plugin-mapbox"
  5 |         version="1.2.3">
  6 | 
  7 |   <name>Mapbox</name>
  8 | 
  9 |   <description>Need native maps? Look no further!</description>
 10 | 
 11 |   <author>Telerik / Eddy Verbruggen</author>
 12 | 
 13 |   <license>MIT</license>
 14 | 
 15 |   <keywords>Mapbox, Maps, Mapping, Native maps</keywords>
 16 | 
 17 |   <repo>https://github.com/Telerik-Verified-Plugins/Mapbox</repo>
 18 | 
 19 |   <preference name="ACCESS_TOKEN" />
 20 | 
 21 |   <engines>
 22 |     <engine name="cordova" version=">=3.5.0"/>
 23 |     <!--engine name="cordova-android" version=">=4" /-->
 24 |     <engine name="cordova-plugman" version=">=4.2.0"/><!-- needed for gradleReference support -->
 25 |   </engines>
 26 | 
 27 |   <js-module src="www/Mapbox.js" name="Mapbox">
 28 |     <clobbers target="Mapbox" />
 29 |   </js-module>
 30 | 
 31 |   <!-- android -->
 32 |   <platform name="android">
 33 |     <config-file target="res/xml/config.xml" parent="/*">
 34 |       <feature name="Mapbox">
 35 |         <param name="android-package" value="com.telerik.plugins.mapbox.Mapbox" />
 36 |       </feature>
 37 |     </config-file>
 38 | 
 39 |     <config-file target="AndroidManifest.xml" parent="/*">
 40 |       <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
 41 |       <uses-permission android:name="android.permission.INTERNET" />
 42 |       <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 43 | 
 44 |       <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
 45 |       <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
 46 |       <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
 47 |     </config-file>
 48 | 
 49 |     <framework src="src/android/mapbox.gradle" custom="true" type="gradleReference"/>
 50 |     <source-file src="src/android/Mapbox.java" target-dir="src/com/telerik/plugins/mapbox"/>
 51 | 
 52 |     <!-- This leads to trouble in AppBuilder when compiling for Cordova-Android 4 -->
 53 |     <!--source-file src="src/android/res/values/mapboxstrings.xml" target-dir="res/values" />
 54 |     <config-file target="res/values/mapboxstrings.xml" parent="/*">
 55 |       <string name="mapbox_accesstoken">$ACCESS_TOKEN</string>
 56 |     </config-file-->
 57 | 
 58 |     <config-file target="res/values/strings.xml" parent="/*">
 59 |       <string name="mapbox_accesstoken">$ACCESS_TOKEN</string>
 60 |     </config-file>
 61 |   </platform>
 62 | 
 63 |   <!-- iOS -->
 64 |   <platform name="ios">
 65 |     <config-file parent="/*" target="config.xml">
 66 |       <feature name="Mapbox">
 67 |         <param name="ios-package" value="CDVMapbox" />
 68 |       </feature>
 69 |     </config-file>
 70 | 
 71 |     <config-file target="*-Info.plist" parent="MGLMapboxAccessToken">
 72 |       <string>$ACCESS_TOKEN</string>
 73 |     </config-file>
 74 |     <config-file target="*-Info.plist" parent="MGLMapboxMetricsEnabledSettingShownInApp">
 75 |       <true/>
 76 |     </config-file>
 77 |     <config-file target="*-Info.plist" parent="NSLocationWhenInUseUsageDescription">
 78 |       <true/>
 79 |     </config-file>
 80 | 
 81 |     <header-file src="src/ios/CDVMapbox.h" />
 82 |     <source-file src="src/ios/CDVMapbox.m" />
 83 | 
 84 |     <!-- Downloaded iOS SDK version 3.0.1 from https://github.com/mapbox/mapbox-gl-native/releases -->
 85 |     <header-file src="src/ios/Headers/Mapbox.h" />
 86 |     <header-file src="src/ios/Headers/MGLAccountManager.h" />
 87 |     <header-file src="src/ios/Headers/MGLAnnotation.h" />
 88 |     <header-file src="src/ios/Headers/MGLAnnotationImage.h" />
 89 |     <header-file src="src/ios/Headers/MGLGeometry.h" />
 90 |     <header-file src="src/ios/Headers/MGLMapCamera.h" />
 91 |     <header-file src="src/ios/Headers/MGLMapView+IBAdditions.h" />
 92 |     <header-file src="src/ios/Headers/MGLMapView.h" />
 93 |     <header-file src="src/ios/Headers/MGLMultiPoint.h" />
 94 |     <header-file src="src/ios/Headers/MGLOverlay.h" />
 95 |     <header-file src="src/ios/Headers/MGLPointAnnotation.h" />
 96 |     <header-file src="src/ios/Headers/MGLPolygon.h" />
 97 |     <header-file src="src/ios/Headers/MGLPolyline.h" />
 98 |     <header-file src="src/ios/Headers/MGLShape.h" />
 99 |     <header-file src="src/ios/Headers/MGLStyle.h" />
100 |     <header-file src="src/ios/Headers/MGLTypes.h" />
101 |     <header-file src="src/ios/Headers/MGLUserLocation.h" />
102 | 
103 |     <source-file src="src/ios/libs/libMapbox.a" framework="true"/>
104 |     <resource-file src="src/ios/libs/Mapbox.bundle" />
105 |     <!-- This bundle adds a mandatory opt-out switch for Mapbox Metrics to the iOS Settings app  -->
106 |     <resource-file src="src/ios/libs/Settings.bundle" />
107 | 
108 |     <framework src="GLKit.framework" weak="true" />
109 |     <framework src="ImageIO.framework" weak="true" />
110 |     <framework src="MobileCoreServices.framework" weak="true" />
111 |     <framework src="QuartzCore.framework" weak="true" />
112 |     <framework src="SystemConfiguration.framework" weak="true" />
113 |     <framework src="libc++.dylib" weak="true" />
114 |     <framework src="libsqlite3.dylib" weak="true" />
115 |     <framework src="libz.dylib" weak="true" />
116 |   </platform>
117 | 
118 | </plugin>
119 | 


--------------------------------------------------------------------------------
/screenshots/android/android-marker-amsterdam.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/screenshots/android/android-marker-amsterdam.png


--------------------------------------------------------------------------------
/screenshots/ios/ios-location-benelux.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/screenshots/ios/ios-location-benelux.png


--------------------------------------------------------------------------------
/screenshots/ios/ios-location-europe-dark-boxed.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/screenshots/ios/ios-location-europe-dark-boxed.png


--------------------------------------------------------------------------------
/screenshots/ios/ios-marker-amsterdam.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/screenshots/ios/ios-marker-amsterdam.png


--------------------------------------------------------------------------------
/src/android/Mapbox.java:
--------------------------------------------------------------------------------
  1 | package com.telerik.plugins.mapbox;
  2 | 
  3 | import android.Manifest;
  4 | import android.content.pm.PackageManager;
  5 | import android.content.res.Resources;
  6 | import android.os.Build;
  7 | import android.support.annotation.NonNull;
  8 | import android.support.v4.app.ActivityCompat;
  9 | import android.util.DisplayMetrics;
 10 | import android.view.ViewGroup;
 11 | import android.widget.FrameLayout;
 12 | import android.graphics.PointF;
 13 | 
 14 | import com.mapbox.mapboxsdk.camera.CameraPosition;
 15 | import com.mapbox.mapboxsdk.camera.CameraUpdateFactory;
 16 | import com.mapbox.mapboxsdk.constants.Style;
 17 | import com.mapbox.mapboxsdk.annotations.Marker;
 18 | import com.mapbox.mapboxsdk.annotations.MarkerOptions;
 19 | import com.mapbox.mapboxsdk.annotations.PolygonOptions;
 20 | import com.mapbox.mapboxsdk.geometry.LatLng;
 21 | import com.mapbox.mapboxsdk.geometry.LatLngZoom;
 22 | import com.mapbox.mapboxsdk.geometry.CoordinateBounds;
 23 | import com.mapbox.mapboxsdk.views.MapView;
 24 | 
 25 | import org.apache.cordova.CallbackContext;
 26 | import org.apache.cordova.CordovaArgs;
 27 | import org.apache.cordova.CordovaInterface;
 28 | import org.apache.cordova.CordovaPlugin;
 29 | import org.apache.cordova.CordovaWebView;
 30 | import org.apache.cordova.PluginResult;
 31 | import org.json.JSONArray;
 32 | import org.json.JSONException;
 33 | import org.json.JSONObject;
 34 | 
 35 | import java.util.HashMap;
 36 | import java.util.Map;
 37 | 
 38 | 
 39 | // TODO for screen rotation, see https://www.mapbox.com/mapbox-android-sdk/#screen-rotation
 40 | // TODO fox Xwalk compat, see nativepagetransitions plugin
 41 | // TODO look at demo app: https://github.com/mapbox/mapbox-gl-native/blob/master/android/java/MapboxGLAndroidSDKTestApp/src/main/java/com/mapbox/mapboxgl/testapp/MainActivity.java
 42 | public class Mapbox extends CordovaPlugin {
 43 | 
 44 |   public static final String FINE_LOCATION = Manifest.permission.ACCESS_FINE_LOCATION;
 45 |   public static final String COARSE_LOCATION = Manifest.permission.ACCESS_COARSE_LOCATION;
 46 |   public static final int LOCATION_REQ_CODE = 0;
 47 | 
 48 |   public static final int PERMISSION_DENIED_ERROR = 20;
 49 | 
 50 |   private static final String MAPBOX_ACCESSTOKEN_RESOURCE_KEY = "mapbox_accesstoken";
 51 | 
 52 |   private static final String ACTION_SHOW = "show";
 53 |   private static final String ACTION_HIDE = "hide";
 54 |   private static final String ACTION_ADD_MARKERS = "addMarkers";
 55 |   private static final String ACTION_REMOVE_ALL_MARKERS = "removeAllMarkers";
 56 |   private static final String ACTION_ADD_MARKER_CALLBACK = "addMarkerCallback";
 57 |   // TODO:
 58 |   // private static final String ACTION_REMOVE_MARKER_CALLBACK = "removeMarkerCallback";
 59 |   private static final String ACTION_ADD_POLYGON = "addPolygon";
 60 |   private static final String ACTION_ADD_GEOJSON = "addGeoJSON";
 61 |   private static final String ACTION_GET_CENTER = "getCenter";
 62 |   private static final String ACTION_SET_CENTER = "setCenter";
 63 |   private static final String ACTION_GET_ZOOMLEVEL = "getZoomLevel";
 64 |   private static final String ACTION_SET_ZOOMLEVEL = "setZoomLevel";
 65 |   private static final String ACTION_GET_BOUNDS = "getBounds";
 66 |   private static final String ACTION_SET_BOUNDS = "setBounds";
 67 |   private static final String ACTION_GET_TILT = "getTilt";
 68 |   private static final String ACTION_SET_TILT = "setTilt";
 69 |   private static final String ACTION_ANIMATE_CAMERA = "animateCamera";
 70 |   private static final String ACTION_ON_REGION_WILL_CHANGE = "onRegionWillChange";
 71 |   private static final String ACTION_ON_REGION_IS_CHANGING = "onRegionIsChanging";
 72 |   private static final String ACTION_ON_REGION_DID_CHANGE = "onRegionDidChange";
 73 |   // TODO:
 74 |   // private static final String ACTION_OFF_REGION_WILL_CHANGE = "offRegionWillChange";
 75 |   // private static final String ACTION_OFF_REGION_IS_CHANGING = "offRegionIsChanging";
 76 |   // private static final String ACTION_OFF_REGION_DID_CHANGE = "offRegionDidChange";
 77 | 
 78 |   public static MapView mapView;
 79 |   private static float retinaFactor;
 80 |   private String accessToken;
 81 |   private CallbackContext callback;
 82 |   private CallbackContext markerCallbackContext;
 83 | 
 84 |   private boolean showUserLocation;
 85 | 
 86 |   @Override
 87 |   public void initialize(CordovaInterface cordova, CordovaWebView webView) {
 88 |     super.initialize(cordova, webView);
 89 | 
 90 |     DisplayMetrics metrics = new DisplayMetrics();
 91 |     cordova.getActivity().getWindowManager().getDefaultDisplay().getMetrics(metrics);
 92 |     retinaFactor = metrics.density;
 93 | 
 94 |     try {
 95 |       int mapboxAccesstokenResourceId = cordova.getActivity().getResources().getIdentifier(MAPBOX_ACCESSTOKEN_RESOURCE_KEY, "string", cordova.getActivity().getPackageName());
 96 |       accessToken = cordova.getActivity().getString(mapboxAccesstokenResourceId);
 97 |     } catch (Resources.NotFoundException e) {
 98 |       // we'll deal with this when the accessToken property is read, but for now let's dump the error:
 99 |       e.printStackTrace();
100 |     }
101 |   }
102 | 
103 |   @Override
104 |   public boolean execute(final String action, final CordovaArgs args, final CallbackContext callbackContext) throws JSONException {
105 | 
106 |     this.callback = callbackContext;
107 | 
108 |     try {
109 |       if (ACTION_SHOW.equals(action)) {
110 |         final JSONObject options = args.getJSONObject(0);
111 |         final String style = getStyle(options.optString("style"));
112 | 
113 |         final JSONObject margins = options.isNull("margins") ? null : options.getJSONObject("margins");
114 |         final int left = applyRetinaFactor(margins == null || margins.isNull("left") ? 0 : margins.getInt("left"));
115 |         final int right = applyRetinaFactor(margins == null || margins.isNull("right") ? 0 : margins.getInt("right"));
116 |         final int top = applyRetinaFactor(margins == null || margins.isNull("top") ? 0 : margins.getInt("top"));
117 |         final int bottom = applyRetinaFactor(margins == null || margins.isNull("bottom") ? 0 : margins.getInt("bottom"));
118 | 
119 |         final JSONObject center = options.isNull("center") ? null : options.getJSONObject("center");
120 | 
121 |         this.showUserLocation = !options.isNull("showUserLocation") && options.getBoolean("showUserLocation");
122 | 
123 |         cordova.getActivity().runOnUiThread(new Runnable() {
124 |           @Override
125 |           public void run() {
126 |             if (accessToken == null) {
127 |               callbackContext.error(MAPBOX_ACCESSTOKEN_RESOURCE_KEY + " not set in strings.xml");
128 |               return;
129 |             }
130 |             mapView = new MapView(webView.getContext(), accessToken);
131 | 
132 |             // need to do this to register a receiver which onPause later needs
133 |             mapView.onResume();
134 |             mapView.onCreate(null);
135 | 
136 |             try {
137 |               mapView.setCompassEnabled(options.isNull("hideCompass") || !options.getBoolean("hideCompass"));
138 |               mapView.setRotateEnabled(options.isNull("disableRotation") || !options.getBoolean("disableRotation"));
139 |               mapView.setScrollEnabled(options.isNull("disableScroll") || !options.getBoolean("disableScroll"));
140 |               mapView.setZoomEnabled(options.isNull("disableZoom") || !options.getBoolean("disableZoom"));
141 |               mapView.setTiltEnabled(options.isNull("disableTilt") || !options.getBoolean("disableTilt"));
142 | 
143 |               // placing these offscreen in case the user wants to hide them
144 |               if (!options.isNull("hideAttribution") && options.getBoolean("hideAttribution")) {
145 |                 mapView.setAttributionMargins(-300, 0, 0, 0);
146 |               }
147 |               if (!options.isNull("hideLogo") && options.getBoolean("hideLogo")) {
148 |                 mapView.setLogoMargins(-300, 0, 0, 0);
149 |               }
150 | 
151 |               if (showUserLocation) {
152 |                 showUserLocation();
153 |               }
154 | 
155 |               Double zoom = options.isNull("zoomLevel") ? 10 : options.getDouble("zoomLevel");
156 |               float zoomLevel = zoom.floatValue();
157 |               if (center != null) {
158 |                 final double lat = center.getDouble("lat");
159 |                 final double lng = center.getDouble("lng");
160 |                 mapView.setLatLng(new LatLngZoom(lat, lng, zoomLevel));
161 |               } else {
162 |                 if (zoomLevel > 18.0) {
163 |                   zoomLevel = 18.0f;
164 |                 }
165 |                 mapView.setZoom(zoomLevel);
166 |               }
167 | 
168 |               if (options.has("markers")) {
169 |                 addMarkers(options.getJSONArray("markers"));
170 |               }
171 |             } catch (JSONException e) {
172 |               callbackContext.error(e.getMessage());
173 |               return;
174 |             }
175 | 
176 |             mapView.setStyleUrl(style);
177 | 
178 |             // position the mapView overlay
179 |             int webViewWidth = webView.getView().getWidth();
180 |             int webViewHeight = webView.getView().getHeight();
181 |             final FrameLayout layout = (FrameLayout) webView.getView().getParent();
182 |             FrameLayout.LayoutParams params = new FrameLayout.LayoutParams(webViewWidth - left - right, webViewHeight - top - bottom);
183 |             params.setMargins(left, top, right, bottom);
184 |             mapView.setLayoutParams(params);
185 | 
186 |             layout.addView(mapView);
187 |             callbackContext.success();
188 |           }
189 |         });
190 | 
191 |       } else if (ACTION_HIDE.equals(action)) {
192 |         if (mapView != null) {
193 | 
194 |           // Remove marker callback handler
195 |           this.markerCallbackContext = null;
196 | 
197 |           cordova.getActivity().runOnUiThread(new Runnable() {
198 |             @Override
199 |             public void run() {
200 |               ViewGroup vg = (ViewGroup) mapView.getParent();
201 | 
202 |               if (vg != null) {
203 |                 vg.removeView(mapView);
204 |               }
205 | 
206 |               callbackContext.success();
207 |             }
208 |           });
209 |         }
210 | 
211 |       } else if (ACTION_GET_CENTER.equals(action)) {
212 |         if (mapView != null) {
213 |           cordova.getActivity().runOnUiThread(new Runnable() {
214 |             @Override
215 |             public void run() {
216 |               final LatLng center = mapView.getLatLng();
217 |               Map<String, Double> result = new HashMap<String, Double>();
218 |               result.put("lat", center.getLatitude());
219 |               result.put("lng", center.getLongitude());
220 |               callbackContext.success(new JSONObject(result));
221 |             }
222 |           });
223 |         }
224 | 
225 |       } else if (ACTION_SET_CENTER.equals(action)) {
226 |         if (mapView != null) {
227 |           cordova.getActivity().runOnUiThread(new Runnable() {
228 |             @Override
229 |             public void run() {
230 |               try {
231 |                 final JSONObject options = args.getJSONObject(0);
232 |                 final boolean animated = !options.isNull("animated") && options.getBoolean("animated");
233 |                 final double lat = options.getDouble("lat");
234 |                 final double lng = options.getDouble("lng");
235 |                 mapView.setLatLng(new LatLng(lat, lng), animated);
236 |                 callbackContext.success();
237 |               } catch (JSONException e) {
238 |                 callbackContext.error(e.getMessage());
239 |               }
240 |             }
241 |           });
242 |         }
243 | 
244 |       } else if (ACTION_GET_ZOOMLEVEL.equals(action)) {
245 |         if (mapView != null) {
246 |           cordova.getActivity().runOnUiThread(new Runnable() {
247 |             @Override
248 |             public void run() {
249 |               final double zoomLevel = mapView.getZoom();
250 |               callbackContext.success("" + zoomLevel);
251 |             }
252 |           });
253 |         }
254 | 
255 |       } else if (ACTION_SET_ZOOMLEVEL.equals(action)) {
256 |         if (mapView != null) {
257 |           cordova.getActivity().runOnUiThread(new Runnable() {
258 |             @Override
259 |             public void run() {
260 |               try {
261 |                 final JSONObject options = args.getJSONObject(0);
262 |                 final double zoom = options.getDouble("level");
263 |                 if (zoom >= 0 && zoom <= 20) {
264 |                   final boolean animated = !options.isNull("animated") && options.getBoolean("animated");
265 |                   mapView.setZoom(zoom, animated);
266 |                   callbackContext.success();
267 |                 } else {
268 |                   callbackContext.error("invalid zoomlevel, use any double value from 0 to 20 (like 8.3)");
269 |                 }
270 |               } catch (JSONException e) {
271 |                 callbackContext.error(e.getMessage());
272 |               }
273 |             }
274 |           });
275 |         }
276 | 
277 | 
278 |       } else if (ACTION_GET_BOUNDS.equals(action)) {
279 |         if (mapView != null) {
280 |           cordova.getActivity().runOnUiThread(new Runnable() {
281 |             @Override
282 |             public void run() {
283 |               // NOTE: need to change to this on a future release           
284 |               // final CoordinateBounds bounds = mapView.getVisibleCoordinateBounds();
285 |               // final LatLng sw = bounds.getSouthWest();
286 |               // final LatLng ne = bounds.getNorthEast();
287 | 
288 |               // NOTE: Workaround, see: https://github.com/mapbox/mapbox-gl-native/issues/3863#issuecomment-181825298
289 |               int viewportWidth = mapView.getWidth();
290 |               int viewportHeight = mapView.getHeight();
291 |               LatLng sw = mapView.fromScreenLocation(new PointF(0, viewportHeight)); // bottom left
292 |               LatLng ne = mapView.fromScreenLocation(new PointF(viewportWidth, 0)); // top right
293 | 
294 |               Map<String, Double> result = new HashMap<String, Double>();
295 |               result.put("sw_lat", sw.getLatitude());
296 |               result.put("sw_lng", sw.getLongitude());
297 |               result.put("ne_lat", ne.getLatitude());
298 |               result.put("ne_lng", ne.getLongitude());
299 |               callbackContext.success(new JSONObject(result));
300 |             }
301 |           });
302 |         }
303 | 
304 |       } else if (ACTION_SET_BOUNDS.equals(action)) {
305 |         if (mapView != null) {
306 |           cordova.getActivity().runOnUiThread(new Runnable() {
307 |             @Override
308 |             public void run() {
309 |               try {
310 |                 final JSONObject options = args.getJSONObject(0);
311 |                 final boolean animated = !options.isNull("animated") && options.getBoolean("animated");
312 |                 final double sw_lat = options.getDouble("sw_lat");
313 |                 final double sw_lng = options.getDouble("sw_lng");
314 |                 final double ne_lat = options.getDouble("ne_lat");
315 |                 final double ne_lng = options.getDouble("ne_lng");
316 |                 final LatLng sw = new LatLng(sw_lat, sw_lng);
317 |                 final LatLng ne = new LatLng(ne_lat, ne_lng);
318 |                 final CoordinateBounds bounds = new CoordinateBounds(sw, ne);
319 |                 mapView.setVisibleCoordinateBounds(bounds, animated);
320 |                 callbackContext.success();
321 |               } catch (JSONException e) {
322 |                 callbackContext.error(e.getMessage());
323 |               }
324 |             }
325 |           });
326 |         }
327 | 
328 |       } else if (ACTION_GET_TILT.equals(action)) {
329 |         if (mapView != null) {
330 |           cordova.getActivity().runOnUiThread(new Runnable() {
331 |             @Override
332 |             public void run() {
333 |               final double tilt = mapView.getTilt();
334 |               callbackContext.success("" + tilt);
335 |             }
336 |           });
337 |         }
338 | 
339 |       } else if (ACTION_SET_TILT.equals(action)) {
340 |         if (mapView != null) {
341 |           cordova.getActivity().runOnUiThread(new Runnable() {
342 |             @Override
343 |             public void run() {
344 |               try {
345 |                 final JSONObject options = args.getJSONObject(0);
346 |                 mapView.setTilt(
347 |                     options.optDouble("pitch", 20),      // default 20
348 |                     options.optLong("duration", 5000)); // default 5s
349 |                 callbackContext.success();
350 |               } catch (JSONException e) {
351 |                 callbackContext.error(e.getMessage());
352 |               }
353 |             }
354 |           });
355 |         }
356 | 
357 |       } else if (ACTION_ANIMATE_CAMERA.equals(action)) {
358 |         if (mapView != null) {
359 |           cordova.getActivity().runOnUiThread(new Runnable() {
360 |             @Override
361 |             public void run() {
362 |               try {
363 |                 // TODO check mandatory elements
364 |                 final JSONObject options = args.getJSONObject(0);
365 | 
366 |                 final JSONObject target = options.getJSONObject("target");
367 |                 final double lat = target.getDouble("lat");
368 |                 final double lng = target.getDouble("lng");
369 | 
370 |                 final CameraPosition.Builder builder =
371 |                     new CameraPosition.Builder()
372 |                         .target(new LatLng(lat, lng));
373 | 
374 |                 if (options.has("bearing")) {
375 |                   builder.bearing(((Double)options.getDouble("bearing")).floatValue());
376 |                 }
377 |                 if (options.has("tilt")) {
378 |                   builder.tilt(((Double)options.getDouble("tilt")).floatValue());
379 |                 }
380 |                 if (options.has("zoomLevel")) {
381 |                   builder.zoom(((Double)options.getDouble("zoomLevel")).floatValue());
382 |                 }
383 | 
384 |                 mapView.animateCamera(
385 |                     CameraUpdateFactory.newCameraPosition(builder.build()),
386 |                     (options.optInt("duration", 15)) * 1000, // default 15 seconds
387 |                     null);
388 | 
389 |                 callbackContext.success();
390 |               } catch (JSONException e) {
391 |                 callbackContext.error(e.getMessage());
392 |               }
393 |             }
394 |           });
395 |         }
396 | 
397 |       } else if (ACTION_ADD_POLYGON.equals(action)) {
398 |         cordova.getActivity().runOnUiThread(new Runnable() {
399 |           @Override
400 |           public void run() {
401 |             try {
402 |               final PolygonOptions polygon = new PolygonOptions();
403 |               final JSONObject options = args.getJSONObject(0);
404 |               final JSONArray points = options.getJSONArray("points");
405 |               for (int i = 0; i < points.length(); i++) {
406 |                 final JSONObject marker = points.getJSONObject(i);
407 |                 final double lat = marker.getDouble("lat");
408 |                 final double lng = marker.getDouble("lng");
409 |                 polygon.add(new LatLng(lat, lng));
410 |               }
411 |               mapView.addPolygon(polygon);
412 | 
413 |               callbackContext.success();
414 |             } catch (JSONException e) {
415 |               callbackContext.error(e.getMessage());
416 |             }
417 |           }
418 |         });
419 | 
420 |       } else if (ACTION_ADD_GEOJSON.equals(action)) {
421 |         cordova.getActivity().runOnUiThread(new Runnable() {
422 |           @Override
423 |           public void run() {
424 |             // TODO implement
425 |             callbackContext.success();
426 |           }
427 |         });
428 | 
429 |       } else if (ACTION_ADD_MARKERS.equals(action)) {
430 |         cordova.getActivity().runOnUiThread(new Runnable() {
431 |           @Override
432 |           public void run() {
433 |             try {
434 |               addMarkers(args.getJSONArray(0));
435 |               callbackContext.success();
436 |             } catch (JSONException e) {
437 |               callbackContext.error(e.getMessage());
438 |             }
439 |           }
440 |         });
441 | 
442 |       } else if (ACTION_REMOVE_ALL_MARKERS.equals(action)) {
443 |         if (mapView != null) {
444 |           cordova.getActivity().runOnUiThread(new Runnable() {
445 |             @Override
446 |             public void run() {
447 |               mapView.removeAllAnnotations();
448 |               callbackContext.success();
449 |             }
450 |           });
451 |         }
452 | 
453 |       } else if (ACTION_ADD_MARKER_CALLBACK.equals(action)) {
454 |         this.markerCallbackContext = callbackContext;
455 |         mapView.setOnInfoWindowClickListener(new MarkerClickListener());
456 | 
457 |       } else if (ACTION_ON_REGION_WILL_CHANGE.equals(action)) {
458 |         if (mapView != null) {
459 |           mapView.addOnMapChangedListener(new RegionWillChangeListener(callbackContext));
460 |         }
461 | 
462 |       } else if (ACTION_ON_REGION_IS_CHANGING.equals(action)) {
463 |         if (mapView != null) {
464 |           mapView.addOnMapChangedListener(new RegionIsChangingListener(callbackContext));
465 |         }
466 | 
467 |       } else if (ACTION_ON_REGION_DID_CHANGE.equals(action)) {
468 |         if (mapView != null) {
469 |           mapView.addOnMapChangedListener(new RegionDidChangeListener(callbackContext));
470 |         }
471 | 
472 |       } else {
473 |         return false;
474 |       }
475 |     } catch (Throwable t) {
476 |       t.printStackTrace();
477 |       callbackContext.error(t.getMessage());
478 |     }
479 |     return true;
480 |   }
481 | 
482 |   private void addMarkers(JSONArray markers) throws JSONException {
483 |     for (int i=0; i<markers.length(); i++) {
484 |       final JSONObject marker = markers.getJSONObject(i);
485 |       final MarkerOptions mo = new MarkerOptions();
486 |       mo.title(marker.isNull("title") ? null : marker.getString("title"));
487 |       mo.snippet(marker.isNull("subtitle") ? null : marker.getString("subtitle"));
488 |       mo.position(new LatLng(marker.getDouble("lat"), marker.getDouble("lng")));
489 |       mapView.addMarker(mo);
490 |     }
491 |   }
492 | 
493 |   private class RegionWillChangeListener implements MapView.OnMapChangedListener {
494 |     private CallbackContext callback;
495 | 
496 |     public RegionWillChangeListener(CallbackContext providedCallback) {
497 |       this.callback = providedCallback;
498 |     }
499 | 
500 |     @Override
501 |     public void onMapChanged(int change) {
502 |       if ( change == MapView.REGION_WILL_CHANGE_ANIMATED ) {
503 |         PluginResult pluginResult = new PluginResult(PluginResult.Status.OK);
504 |         pluginResult.setKeepCallback(true);
505 |         callback.sendPluginResult(pluginResult);
506 |       }
507 |     }
508 |   }
509 | 
510 |   private class RegionIsChangingListener implements MapView.OnMapChangedListener {
511 |     private CallbackContext callback;
512 | 
513 |     public RegionIsChangingListener(CallbackContext providedCallback) {
514 |       this.callback = providedCallback;
515 |     }
516 | 
517 |     @Override
518 |     public void onMapChanged(int change) {
519 |       if ( change == MapView.REGION_IS_CHANGING ) {
520 |         PluginResult pluginResult = new PluginResult(PluginResult.Status.OK);
521 |         pluginResult.setKeepCallback(true);
522 |         callback.sendPluginResult(pluginResult);
523 |       }
524 |     }
525 |   }
526 | 
527 |   private class RegionDidChangeListener implements MapView.OnMapChangedListener {
528 |     private CallbackContext callback;
529 | 
530 |     public RegionDidChangeListener(CallbackContext providedCallback) {
531 |       this.callback = providedCallback;
532 |     }
533 | 
534 |     @Override
535 |     public void onMapChanged(int change) {
536 |       if ( change == MapView.REGION_DID_CHANGE_ANIMATED ) {
537 |         PluginResult pluginResult = new PluginResult(PluginResult.Status.OK);
538 |         pluginResult.setKeepCallback(true);
539 |         callback.sendPluginResult(pluginResult);
540 |       }
541 |     }
542 |   }
543 | 
544 |   private class MarkerClickListener implements MapView.OnInfoWindowClickListener {
545 | 
546 |     @Override
547 |     public boolean onMarkerClick(@NonNull Marker marker) {
548 |       // callback
549 |       if (markerCallbackContext != null) {
550 |         final JSONObject json = new JSONObject();
551 |         try {
552 |           json.put("title", marker.getTitle());
553 |           json.put("subtitle", marker.getSnippet());
554 |           json.put("lat", marker.getPosition().getLatitude());
555 |           json.put("lng", marker.getPosition().getLongitude());
556 |         } catch (JSONException e) {
557 |           PluginResult pluginResult = new PluginResult(PluginResult.Status.ERROR,
558 |               "Error in callback of " + ACTION_ADD_MARKER_CALLBACK + ": " + e.getMessage());
559 |           pluginResult.setKeepCallback(true);
560 |           markerCallbackContext.sendPluginResult(pluginResult);
561 |         }
562 |         PluginResult pluginResult = new PluginResult(PluginResult.Status.OK, json);
563 |         pluginResult.setKeepCallback(true);
564 |         markerCallbackContext.sendPluginResult(pluginResult);
565 |         return true;
566 |       }
567 |       return false;
568 |     }
569 |   }
570 | 
571 |   private static int applyRetinaFactor(int i) {
572 |     return (int) (i * retinaFactor);
573 |   }
574 | 
575 |   private static String getStyle(final String requested) {
576 |     if ("light".equalsIgnoreCase(requested)) {
577 |       return Style.LIGHT;
578 |     } else if ("dark".equalsIgnoreCase(requested)) {
579 |       return Style.DARK;
580 |     } else if ("emerald".equalsIgnoreCase(requested)) {
581 |       return Style.EMERALD;
582 |     } else if ("satellite".equalsIgnoreCase(requested)) {
583 |       return Style.SATELLITE;
584 |       // TODO not currently supported on Android
585 | //    } else if ("hybrid".equalsIgnoreCase(requested)) {
586 | //      return Style.HYBRID;
587 |     } else if ("streets".equalsIgnoreCase(requested)) {
588 |       return Style.MAPBOX_STREETS;
589 |     } else {
590 |       return requested;
591 |     }
592 |   }
593 | 
594 |   private boolean permissionGranted(String... types) {
595 |     if (Build.VERSION.SDK_INT < 23) {
596 |       return true;
597 |     }
598 |     for (final String type : types) {
599 |       if (PackageManager.PERMISSION_GRANTED != ActivityCompat.checkSelfPermission(this.cordova.getActivity(), type)) {
600 |         return false;
601 |       }
602 |     }
603 |     return true;
604 |   }
605 | 
606 |   protected void showUserLocation() {
607 |     if (permissionGranted(COARSE_LOCATION, FINE_LOCATION)) {
608 |       //noinspection MissingPermission
609 |       mapView.setMyLocationEnabled(showUserLocation);
610 |     } else {
611 |       requestPermission(COARSE_LOCATION, FINE_LOCATION);
612 |     }
613 |   }
614 | 
615 | 
616 |   private void requestPermission(String... types) {
617 |     ActivityCompat.requestPermissions(
618 |         this.cordova.getActivity(),
619 |         types,
620 |         LOCATION_REQ_CODE);
621 |   }
622 | 
623 |   // TODO
624 |   public void onRequestPermissionResult(int requestCode, String[] permissions, int[] grantResults) throws JSONException {
625 |     for (int r : grantResults) {
626 |       if (r == PackageManager.PERMISSION_DENIED) {
627 |         this.callback.sendPluginResult(new PluginResult(PluginResult.Status.ERROR, PERMISSION_DENIED_ERROR));
628 |         return;
629 |       }
630 |     }
631 |     switch (requestCode) {
632 |       case LOCATION_REQ_CODE:
633 |         showUserLocation();
634 |         break;
635 |     }
636 |   }
637 | 
638 |   public void onPause(boolean multitasking) {
639 |     if (mapView != null) {
640 |       mapView.onPause();
641 |     }
642 |   }
643 | 
644 |   public void onResume(boolean multitasking) {
645 |     if (mapView != null) {
646 |       mapView.onResume();
647 |     }
648 |   }
649 | 
650 |   public void onDestroy() {
651 |     if (mapView != null) {
652 |       mapView.onDestroy();
653 |     }
654 |   }
655 | }
656 | 


--------------------------------------------------------------------------------
/src/android/mapbox.gradle:
--------------------------------------------------------------------------------
 1 | ext.cdvMinSdkVersion = 19
 2 | 
 3 | repositories {
 4 |     mavenCentral()
 5 |     maven { url "http://oss.sonatype.org/content/repositories/snapshots/" }
 6 | }
 7 | 
 8 | 
 9 | dependencies {
10 |     compile 'com.android.support:appcompat-v7:23.0.1'
11 |     compile ('com.mapbox.mapboxsdk:mapbox-android-sdk:3.2.0@aar'){
12 |         transitive=true
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/src/android/res/values/mapboxstrings.xml:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="utf-8"?>
2 | <resources>
3 | </resources>


--------------------------------------------------------------------------------
/src/ios/CDVMapbox.h:
--------------------------------------------------------------------------------
 1 | #import <Cordova/CDVPlugin.h>
 2 | #import "Mapbox.h"
 3 | 
 4 | @interface CDVMapbox : CDVPlugin<MGLMapViewDelegate>
 5 | 
 6 | @property (retain) MGLMapView *mapView;
 7 | @property (retain) NSString *markerCallbackId;
 8 | @property (retain) MGLPointAnnotation *selectedAnnotation;
 9 | @property (retain) NSString *regionWillChangeAnimatedCallbackId;
10 | @property (retain) NSString *regionIsChangingCallbackId;
11 | @property (retain) NSString *regionDidChangeAnimatedCallbackId;
12 | 
13 | - (void) show:(CDVInvokedUrlCommand*)command;
14 | - (void) hide:(CDVInvokedUrlCommand*)command;
15 | 
16 | - (void) addMarkers:(CDVInvokedUrlCommand*)command;
17 | - (void) removeAllMarkers:(CDVInvokedUrlCommand*)command;
18 | - (void) addMarkerCallback:(CDVInvokedUrlCommand*)command;
19 | 
20 | - (void) animateCamera:(CDVInvokedUrlCommand*)command;
21 | 
22 | - (void) addPolygon:(CDVInvokedUrlCommand*)command;
23 | 
24 | - (void) addGeoJSON:(CDVInvokedUrlCommand*)command;
25 | 
26 | - (void) getCenter:(CDVInvokedUrlCommand*)command;
27 | - (void) setCenter:(CDVInvokedUrlCommand*)command;
28 | 
29 | - (void) getZoomLevel:(CDVInvokedUrlCommand*)command;
30 | - (void) setZoomLevel:(CDVInvokedUrlCommand*)command;
31 | 
32 | - (void) getBounds:(CDVInvokedUrlCommand*)command;
33 | - (void) setBounds:(CDVInvokedUrlCommand*)command;
34 | 
35 | - (void) getTilt:(CDVInvokedUrlCommand*)command;
36 | - (void) setTilt:(CDVInvokedUrlCommand*)command;
37 | 
38 | - (void) convertCoordinate:(CDVInvokedUrlCommand*)command;
39 | - (void) convertPoint:(CDVInvokedUrlCommand*)command;
40 | 
41 | - (void) onRegionWillChange:(CDVInvokedUrlCommand*)command;
42 | - (void) onRegionIsChanging:(CDVInvokedUrlCommand*)command;
43 | - (void) onRegionDidChange:(CDVInvokedUrlCommand*)command;
44 | 
45 | @end
46 | 


--------------------------------------------------------------------------------
/src/ios/CDVMapbox.m:
--------------------------------------------------------------------------------
  1 | #import "CDVMapbox.h"
  2 | 
  3 | @implementation CDVMapbox
  4 | 
  5 | - (void) show:(CDVInvokedUrlCommand*)command {
  6 |   NSDictionary *args = [command.arguments objectAtIndex:0];
  7 | 
  8 |   NSURL* mapStyle = [self getMapStyle:[args objectForKey:@"style"]];
  9 | 
 10 |   // where shall we show the map overlay?
 11 |   NSDictionary *margins = [args objectForKey:@"margins"];
 12 |   // note that these will correctly fall back to 0 if not passed in
 13 |   int left = [[margins objectForKey:@"left"] intValue];
 14 |   int right = [[margins objectForKey:@"right"] intValue];
 15 |   int top = [[margins objectForKey:@"top"] intValue];
 16 |   int bottom = [[margins objectForKey:@"bottom"] intValue];
 17 | 
 18 |   CGRect webviewFrame = self.webView.frame;
 19 | 
 20 |   CGRect mapFrame = CGRectMake(left, top, webviewFrame.size.width - left - right, webviewFrame.size.height - top - bottom);
 21 | 
 22 |   _mapView = [[MGLMapView alloc] initWithFrame:mapFrame
 23 |                                       styleURL:mapStyle];
 24 | 
 25 |   _mapView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
 26 | 
 27 |   NSNumber *zoomLevel = [args valueForKey:@"zoomLevel"];
 28 |   if (zoomLevel == nil) {
 29 |     // we need a default
 30 |     zoomLevel = [NSNumber numberWithDouble:10.0];
 31 |   }
 32 |   NSDictionary *center = [args objectForKey:@"center"];
 33 |   if (center != nil) {
 34 |     NSNumber *clat = [center valueForKey:@"lat"];
 35 |     NSNumber *clng = [center valueForKey:@"lng"];
 36 |     [_mapView setCenterCoordinate:CLLocationCoordinate2DMake(clat.doubleValue, clng.doubleValue)
 37 |                         zoomLevel:zoomLevel.doubleValue
 38 |                          animated:NO];
 39 |   } else {
 40 |     [_mapView setZoomLevel:zoomLevel.doubleValue];
 41 |   }
 42 | 
 43 | 
 44 |   _mapView.delegate = self;
 45 | 
 46 |   // default NO, note that this requires adding `NSLocationWhenInUseUsageDescription` or `NSLocationAlwaysUsageDescription` to the plist
 47 |   _mapView.showsUserLocation = [[args objectForKey:@"showUserLocation"] boolValue];
 48 | 
 49 |   // default NO
 50 |   _mapView.attributionButton.hidden = [[args objectForKey:@"hideAttribution"] boolValue];
 51 | 
 52 |   // default NO - required for the 'starter' plan
 53 |   _mapView.logoView.hidden = [[args objectForKey:@"hideLogo"] boolValue];
 54 | 
 55 |   // default NO
 56 |   _mapView.compassView.hidden = [[args objectForKey:@"hideCompass"] boolValue];
 57 | 
 58 |   // default YES
 59 |   _mapView.rotateEnabled = ![[args objectForKey:@"disableRotation"] boolValue];
 60 | 
 61 |   // default YES
 62 |   _mapView.pitchEnabled = ![[args objectForKey:@"disablePitch"] boolValue];
 63 | 
 64 |   // default YES
 65 |   _mapView.allowsTilting = ![[args objectForKey:@"disableTilt"] boolValue];
 66 | 
 67 |   // default YES
 68 |   _mapView.scrollEnabled = ![[args objectForKey:@"disableScroll"] boolValue];
 69 | 
 70 |   // default YES
 71 |   _mapView.zoomEnabled = ![[args objectForKey:@"disableZoom"] boolValue];
 72 | 
 73 |   [self.webView addSubview:_mapView];
 74 | 
 75 |   // render markers async as the app will crash if we add it before the map is loaded.. and the delegate events are not sufficiently helpful
 76 |   NSArray* markers = [args objectForKey:@"markers"];
 77 |   if (markers != nil) {
 78 |     // Draw the markers after the map has initialized
 79 |     [self performSelector:@selector(putMarkersOnTheMap:) withObject:markers afterDelay:1.0];
 80 |   }
 81 | 
 82 |   CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
 83 |   [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
 84 | }
 85 | 
 86 | - (void) hide:(CDVInvokedUrlCommand*)command {
 87 |   [_mapView removeFromSuperview];
 88 | 
 89 |   CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
 90 |   [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
 91 | }
 92 | 
 93 | - (void) getCenter:(CDVInvokedUrlCommand*)command {
 94 |     CLLocationCoordinate2D ctr = _mapView.centerCoordinate;
 95 |     NSDictionary *dic = [NSDictionary dictionaryWithObjectsAndKeys:
 96 |                          [NSNumber numberWithDouble:ctr.latitude], @"lat",
 97 |                          [NSNumber numberWithDouble:ctr.longitude], @"lng",
 98 |                          nil];
 99 |     CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:dic];
100 |     [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
101 | }
102 | 
103 | - (void) setCenter:(CDVInvokedUrlCommand*)command {
104 |   NSDictionary *args = [command.arguments objectAtIndex:0];
105 |   NSNumber *clat = [args valueForKey:@"lat"];
106 |   NSNumber *clng = [args valueForKey:@"lng"];
107 |   BOOL animated = [[args objectForKey:@"animated"] boolValue];
108 |   [_mapView setCenterCoordinate:CLLocationCoordinate2DMake(clat.doubleValue, clng.doubleValue) animated:animated];
109 | 
110 |   CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
111 |   [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
112 | }
113 | 
114 | - (void) setTilt:(CDVInvokedUrlCommand*)command {
115 |   // TODO tilt/pitch seems not to be implemented in Mapbox iOS SDK (yet)
116 |   CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"not implemented for iOS (yet)"];
117 |   [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
118 | }
119 | 
120 | - (void) getTilt:(CDVInvokedUrlCommand*)command {
121 |   // TODO seems not to be implemented in Mapbox iOS SDK (yet)
122 |   CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"not implemented for iOS (yet)"];
123 |   [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
124 | }
125 | 
126 | - (void) setZoomLevel:(CDVInvokedUrlCommand*)command {
127 |   NSDictionary *args = [command.arguments objectAtIndex:0];
128 |   NSNumber *level = [args objectForKey:@"level"];
129 |   BOOL animated = [[args objectForKey:@"animated"] boolValue];
130 |   double zoom = level.doubleValue;
131 |   if (zoom >= 0 && zoom <= 20) {
132 |     [_mapView setZoomLevel:zoom animated:animated];
133 |     CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
134 |     [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
135 |   } else {
136 |     CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"invalid zoomlevel, use any double value from 0 to 20 (like 8.3)"];
137 |     [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
138 |   }
139 | }
140 | 
141 | - (void) getZoomLevel:(CDVInvokedUrlCommand*)command {
142 |   double zoom = _mapView.zoomLevel;
143 |   CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDouble:zoom];
144 |   [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
145 | }
146 | 
147 | - (void) getBounds:(CDVInvokedUrlCommand*)command {
148 |     MGLCoordinateBounds bounds = _mapView.visibleCoordinateBounds;
149 |     NSDictionary *dic = [NSDictionary dictionaryWithObjectsAndKeys:
150 |                          [NSNumber numberWithDouble:bounds.sw.latitude], @"sw_lat",
151 |                          [NSNumber numberWithDouble:bounds.sw.longitude], @"sw_lng",
152 |                          [NSNumber numberWithDouble:bounds.ne.latitude], @"ne_lat",
153 |                          [NSNumber numberWithDouble:bounds.ne.longitude], @"ne_lng",
154 |                          nil];
155 |     CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:dic];
156 |     [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
157 | }
158 | 
159 | - (void) setBounds:(CDVInvokedUrlCommand*)command {
160 |     CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"not implemented for iOS (yet)"];
161 |     [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
162 | }
163 | 
164 | - (void)animateCamera:(CDVInvokedUrlCommand*)command {
165 |   NSDictionary *args = [command.arguments objectAtIndex:0];
166 | 
167 |   MGLMapCamera * cam = [MGLMapCamera camera];
168 | 
169 |   NSNumber *altitude = [args valueForKey:@"altitude"];
170 |   if (altitude != nil) {
171 |     cam.altitude = [altitude doubleValue];
172 |   }
173 | 
174 |   NSNumber *tilt = [args valueForKey:@"tilt"];
175 |   if (tilt != nil) {
176 |     cam.pitch = [tilt floatValue];
177 |   }
178 | 
179 |   NSNumber *bearing = [args valueForKey:@"bearing"];
180 |   if (bearing != nil) {
181 |     cam.heading = [bearing floatValue];
182 |   }
183 | 
184 |   NSTimeInterval durInt = 15; // default 15
185 |   NSNumber *duration = [args valueForKey:@"duration"];
186 |   if (duration != nil) {
187 |     durInt = [duration intValue];
188 |   }
189 | 
190 |   NSDictionary *target = [args objectForKey:@"target"];
191 |   if (target != nil) {
192 |     NSNumber *clat = [target valueForKey:@"lat"];
193 |     NSNumber *clng = [target valueForKey:@"lng"];
194 |     cam.centerCoordinate = CLLocationCoordinate2DMake(clat.doubleValue, clng.doubleValue);
195 |   }
196 | 
197 |   [_mapView setCamera:cam withDuration:durInt animationTimingFunction:[CAMediaTimingFunction functionWithName:kCAMediaTimingFunctionEaseInEaseOut]];
198 | 
199 |   CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
200 |   [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
201 | }
202 | 
203 | - (void)addPolygon:(CDVInvokedUrlCommand*)command {
204 |   NSDictionary *args = [command.arguments objectAtIndex:0];
205 |   NSArray* points = [args objectForKey:@"points"];
206 |   if (points != nil) {
207 |     [self.commandDelegate runInBackground:^{
208 |         CLLocationCoordinate2D *coordinates = malloc(points.count * sizeof(CLLocationCoordinate2D));
209 |         for (int i=0; i<points.count; i++) {
210 |           NSDictionary* point = points[i];
211 |           NSNumber *lat = [point valueForKey:@"lat"];
212 |           NSNumber *lng = [point valueForKey:@"lng"];
213 |           coordinates[i] = CLLocationCoordinate2DMake(lat.doubleValue, lng.doubleValue);
214 |         }
215 |         NSUInteger numberOfCoordinates = points.count; // sizeof(coordinates) / sizeof(CLLocationCoordinate2D);
216 |         MGLPolygon *shape = [MGLPolygon polygonWithCoordinates:coordinates count:numberOfCoordinates];
217 |         [_mapView addAnnotation:shape];
218 |         CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
219 |         [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
220 |     }];
221 |   } else {
222 |     CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
223 |     [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
224 |   }
225 | }
226 | 
227 | - (void) addGeoJSON:(CDVInvokedUrlCommand*)command {
228 | //  NSString *url = [command.arguments objectAtIndex:0];
229 | // TODO not implemented yet, see https://www.mapbox.com/ios-sdk/examples/line-geojson/
230 |   CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
231 |   [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
232 | }
233 | 
234 | - (void) addMarkers:(CDVInvokedUrlCommand*)command {
235 |   NSArray *markers = [command.arguments objectAtIndex:0];
236 |   if (markers != nil) {
237 |     [self putMarkersOnTheMap:markers];
238 |   }
239 | 
240 |   CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
241 |   [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
242 | }
243 | 
244 | - (void) removeAllMarkers:(CDVInvokedUrlCommand*)command {
245 |   NSArray *annotations = _mapView.annotations;
246 |   if (annotations) {
247 |     [_mapView removeAnnotations:annotations];
248 |   }
249 | 
250 |   CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
251 |   [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
252 | }
253 | 
254 | - (void) addMarkerCallback:(CDVInvokedUrlCommand*)command {
255 |   self.markerCallbackId = command.callbackId;
256 | }
257 | 
258 | - (void) putMarkersOnTheMap:(NSArray *)markers {
259 |   [self.commandDelegate runInBackground:^{
260 |       for (int i = 0; i < markers.count; i++) {
261 |         NSDictionary* marker = markers[i];
262 |         MGLPointAnnotation *point = [[MGLPointAnnotation alloc] init];
263 |         NSNumber *lat = [marker valueForKey:@"lat"];
264 |         NSNumber *lng = [marker valueForKey:@"lng"];
265 |         point.coordinate = CLLocationCoordinate2DMake(lat.doubleValue, lng.doubleValue);
266 |         point.title = [marker valueForKey:@"title"];
267 |         point.subtitle = [marker valueForKey:@"subtitle"];
268 |         [_mapView addAnnotation:point];
269 |       }
270 |   }];
271 | }
272 | 
273 | - (void) convertCoordinate:(CDVInvokedUrlCommand *)command {
274 |   NSDictionary *args = command.arguments[0];
275 | 
276 |   double lat = [[args valueForKey:@"lat"]doubleValue];
277 |   double lng = [[args valueForKey:@"lng"]doubleValue];
278 | 
279 |   if ((fabs(lat) > 90)||(fabs(lng) > 180)){
280 |     CDVPluginResult * pluginResult = [CDVPluginResult
281 |             resultWithStatus:CDVCommandStatus_ERROR
282 |              messageAsString:@"Incorrect Leaflet.LatLng value."];
283 |     [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
284 |   }
285 | 
286 |   CGPoint screenPoint = [_mapView  convertCoordinate:CLLocationCoordinate2DMake(lat, lng)
287 |                                        toPointToView:_mapView];
288 | 
289 |   NSDictionary *point = @{@"x" : @(screenPoint.x), @"y" : @(screenPoint.y)};
290 | 
291 |   CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:point];
292 | 
293 |   [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
294 | }
295 | 
296 | - (void) convertPoint:(CDVInvokedUrlCommand *)command {
297 |   NSDictionary *args = command.arguments[0];
298 | 
299 |   float x = [[args valueForKey:@"x"] floatValue];
300 |   float y = [[args valueForKey:@"y"] floatValue];
301 | 
302 |   if ((x < 0 || y < 0)){
303 |     CDVPluginResult * pluginResult = [CDVPluginResult
304 |             resultWithStatus:CDVCommandStatus_ERROR
305 |              messageAsString:@"Incorrect Leaflet.Point point coordinates."];
306 |     [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
307 |   }
308 | 
309 |   CLLocationCoordinate2D location = [_mapView convertPoint:CGPointMake(x, y)
310 |                                       toCoordinateFromView:_mapView];
311 | 
312 |   NSDictionary *coordinates = @{@"lat" : @(location.latitude), @"lng" : @(location.longitude)};
313 | 
314 |   CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:coordinates];
315 | 
316 |   [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
317 | }
318 | 
319 | - (void) onRegionWillChange:(CDVInvokedUrlCommand*)command {
320 |   self.regionWillChangeAnimatedCallbackId = command.callbackId;
321 | }
322 | 
323 | - (void) onRegionIsChanging:(CDVInvokedUrlCommand*)command {
324 |   self.regionIsChangingCallbackId = command.callbackId;
325 | }
326 | 
327 | - (void) onRegionDidChange:(CDVInvokedUrlCommand*)command {
328 |   self.regionDidChangeAnimatedCallbackId = command.callbackId;
329 | }
330 | #pragma mark - MGLMapViewDelegate
331 | 
332 | // this method is invoked every time an annotation is clicked
333 | - (BOOL)mapView:(MGLMapView *)mapView annotationCanShowCallout:(id <MGLAnnotation>)annotation {
334 |   return YES;
335 | }
336 | 
337 | //- (MGLAnnotationImage *)mapView:(MGLMapView *)mapView imageForAnnotation:(id <MGLAnnotation>)annotation {
338 | // TODO should be able to use an img from www/
339 | //  MGLAnnotationImage *annotationImage = [mapView dequeueReusableAnnotationImageWithIdentifier:@"pisa"];
340 | 
341 | //  if (!annotationImage) {
342 | // Leaning Tower of Pisa by Stefan Spieler from the Noun Project
343 | //    UIImage *image = [UIImage imageNamed:@"pisa"];
344 | //    annotationImage = [MGLAnnotationImage annotationImageWithImage:image reuseIdentifier:@"pisa"];
345 | //  }
346 | 
347 | //  return annotationImage;
348 | //}
349 | 
350 | - (nullable UIView *)mapView:(MGLMapView *)mapView rightCalloutAccessoryViewForAnnotation:(id <MGLAnnotation>)annotation {
351 |   if (self.markerCallbackId != nil) {
352 |     self.selectedAnnotation = annotation;
353 |     UIButton *butt = [UIButton buttonWithType:UIButtonTypeDetailDisclosure];
354 |     [butt addTarget:self action:@selector(annotationInfoButtonTouched:) forControlEvents:UIControlEventTouchDown];
355 |     return butt;
356 |   } else {
357 |     return nil;
358 |   }
359 | }
360 | 
361 | - (void) annotationInfoButtonTouched:(UIButton *)sender {
362 |   if (self.markerCallbackId != nil && self.selectedAnnotation != nil) {
363 |     NSMutableDictionary* returnInfo = [NSMutableDictionary dictionaryWithCapacity:4];
364 |     [returnInfo setObject:self.selectedAnnotation.title forKey:@"title"];
365 |     if (self.selectedAnnotation.subtitle != nil) {
366 |       [returnInfo setObject:self.selectedAnnotation.subtitle forKey:@"subtitle"];
367 |     }
368 |     [returnInfo setObject:[NSNumber numberWithDouble:self.selectedAnnotation.coordinate.latitude] forKey:@"lat"];
369 |     [returnInfo setObject:[NSNumber numberWithDouble:self.selectedAnnotation.coordinate.longitude] forKey:@"lng"];
370 | 
371 |     CDVPluginResult *result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:returnInfo];
372 |     [result setKeepCallbackAsBool:YES];
373 |     [self.commandDelegate sendPluginResult:result callbackId:self.markerCallbackId];
374 |   }
375 | }
376 | 
377 | - (NSURL*) getMapStyle:(NSString*) input {
378 |   if ([input isEqualToString:@"light"]) {
379 |     return [MGLStyle lightStyleURL];
380 |   } else if ([input isEqualToString:@"dark"]) {
381 |     return [MGLStyle darkStyleURL];
382 |   } else if ([input isEqualToString:@"emerald"]) {
383 |     return [MGLStyle emeraldStyleURL];
384 |   } else if ([input isEqualToString:@"satellite"]) {
385 |     return [MGLStyle satelliteStyleURL];
386 |   } else if ([input isEqualToString:@"hybrid"]) {
387 |     return [MGLStyle hybridStyleURL];
388 |   } else if ( input != nil ) {
389 |     NSURL *url = [NSURL URLWithString:input];
390 |     return url;
391 |   } else {
392 |     return [MGLStyle streetsStyleURL];
393 |   }
394 | }
395 | 
396 | - (NSMutableDictionary*) getResultOnMapChange{
397 | 
398 |   NSMutableDictionary* returnInfo = [NSMutableDictionary dictionary];
399 |   MGLMapCamera* camera = _mapView.camera;
400 | 
401 |   returnInfo[@"lat"] = @(_mapView.centerCoordinate.latitude);
402 |   returnInfo[@"lng"] = @(_mapView.centerCoordinate.longitude);
403 |   returnInfo[@"camAltitude"] = @(_mapView.camera.altitude);
404 |   returnInfo[@"camPitch"] = @(_mapView.camera.pitch);
405 |   returnInfo[@"camHeading"] = @(_mapView.camera.heading);
406 | 
407 |   return returnInfo;
408 | }
409 | 
410 | 
411 | - (void)mapView:(nonnull MGLMapView *)mapView regionWillChangeAnimated:(BOOL)animated {
412 |   if (self.regionWillChangeAnimatedCallbackId != nil) {
413 | 
414 |     NSMutableDictionary* returnInfo = [self getResultOnMapChange];
415 | 
416 |     CDVPluginResult *result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:returnInfo];
417 |     [result setKeepCallbackAsBool:YES];
418 |     [self.commandDelegate sendPluginResult:result callbackId:self.regionWillChangeAnimatedCallbackId];
419 |   }
420 | };
421 | 
422 | - (void)mapViewRegionIsChanging:(nonnull MGLMapView *)mapView{
423 |   if (self.regionIsChangingCallbackId != nil) {
424 | 
425 |     NSMutableDictionary* returnInfo = [self getResultOnMapChange];
426 | 
427 |     CDVPluginResult *result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:returnInfo];
428 |     [result setKeepCallbackAsBool:YES];
429 |     [self.commandDelegate sendPluginResult:result callbackId:self.regionIsChangingCallbackId];
430 |   }
431 | };
432 | 
433 | - (void)mapView:(nonnull MGLMapView *)mapView regionDidChangeAnimated:(BOOL)animated{
434 |   if (self.regionDidChangeAnimatedCallbackId != nil) {
435 | 
436 |     NSMutableDictionary* returnInfo = [self getResultOnMapChange];
437 | 
438 |     CDVPluginResult *result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:returnInfo];
439 |     [result setKeepCallbackAsBool:YES];
440 |     [self.commandDelegate sendPluginResult:result callbackId:self.regionDidChangeAnimatedCallbackId];
441 |   }
442 | };
443 | 
444 | @end
445 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLAccountManager.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | 
 3 | #import "MGLTypes.h"
 4 | 
 5 | NS_ASSUME_NONNULL_BEGIN
 6 | 
 7 | /** The MGLAccountManager object provides a global way to set a Mapbox API access token, as well as other settings used framework-wide. */
 8 | @interface MGLAccountManager : NSObject
 9 | 
10 | /** @name Authorizing Access */
11 | 
12 | /** Set the Mapbox API access token for the framework.
13 | *
14 | *   You can set an access token on MGLAccountManager or on an individual map view. The same token is used throughout the framework.
15 | *   @param accessToken The Mapbox API access token. */
16 | + (void)setAccessToken:(nullable NSString *)accessToken;
17 | 
18 | /** Retreive the Mapbox API access token for the framework.
19 | *
20 | *   You can set an access token on MGLAccountManager or on an individual map view. The same token is used throughout the framework.
21 | *   @return accessToken The Mapbox API access token. */
22 | + (nullable NSString *)accessToken;
23 | 
24 | /** @name Providing User Metrics Opt-Out */
25 | 
26 | /** Whether in-app user metrics opt-out is configured. If set to the default value of `NO`, a user opt-out preference is expected in a `Settings.bundle` that shows in the application's section within the system Settings app. */
27 | + (BOOL)mapboxMetricsEnabledSettingShownInApp;
28 | 
29 | @end
30 | 
31 | NS_ASSUME_NONNULL_END
32 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLAnnotation.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | #import <CoreLocation/CoreLocation.h>
 3 | 
 4 | #import "MGLTypes.h"
 5 | 
 6 | NS_ASSUME_NONNULL_BEGIN
 7 | 
 8 | /** The `MGLAnnotation` protocol is used to provide annotation-related information to a map view. To use this protocol, you adopt it in any custom objects that store or represent annotation data. Each object then serves as the source of information about a single map annotation and provides critical information, such as the annotation’s location on the map. Annotation objects do not provide the visual representation of the annotation but typically coordinate (in conjunction with the map view’s delegate) the creation of an appropriate objects to handle the display.
 9 | *
10 | *   An object that adopts this protocol must implement the `coordinate` property. The other methods of this protocol are optional. */
11 | @protocol MGLAnnotation <NSObject>
12 | 
13 | /** @name Position Attributes */
14 | 
15 | /** The center point (specified as a map coordinate) of the annotation. (required) (read-only) */
16 | @property (nonatomic, readonly) CLLocationCoordinate2D coordinate;
17 | 
18 | @optional
19 | 
20 | /** @name Title Attributes */
21 | 
22 | /** The string containing the annotation’s title.
23 | *
24 | * Although this property is optional, if you support the selection of annotations in your map view, you are expected to provide this property. This string is displayed in the callout for the associated annotation. */
25 | @property (nonatomic, readonly, copy, nullable) NSString *title;
26 | 
27 | /** The string containing the annotation’s subtitle.
28 | *
29 | *   This string is displayed in the callout for the associated annotation. */
30 | @property (nonatomic, readonly, copy, nullable) NSString *subtitle;
31 | 
32 | @end
33 | 
34 | NS_ASSUME_NONNULL_END
35 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLAnnotationImage.h:
--------------------------------------------------------------------------------
 1 | #import <UIKit/UIKit.h>
 2 | 
 3 | #import "MGLTypes.h"
 4 | 
 5 | NS_ASSUME_NONNULL_BEGIN
 6 | 
 7 | /** The MGLAnnotationImage class is responsible for presenting point-based annotations visually on a map view. Annotation image objects wrap `UIImage` objects and may be recycled later and put into a reuse queue that is maintained by the map view. */
 8 | @interface MGLAnnotationImage : NSObject
 9 | 
10 | /** @name Initializing and Preparing the Image Object */
11 | 
12 | /** Initializes and returns a new annotation image object.
13 | *   @param image The image to be displayed for the annotation.
14 | *   @param reuseIdentifier The string that identifies that this annotation image is reusable.
15 | *   @return The initialized annotation image object or `nil` if there was a problem initializing the object. */
16 | + (instancetype)annotationImageWithImage:(UIImage *)image reuseIdentifier:(NSString *)reuseIdentifier;
17 | 
18 | /** @name Getting and Setting Attributes */
19 | 
20 | /** The image to be displayed for the annotation. */
21 | @property (nonatomic, readonly) UIImage *image;
22 | 
23 | /** The string that identifies that this annotation image is reusable. (read-only)
24 | *
25 | *   You specify the reuse identifier when you create the image object. You use this type later to retrieve an annotation image object that was created previously but which is currently unused because its annotation is not on screen.
26 | *
27 | *   If you define distinctly different types of annotations (with distinctly different annotation images to go with them), you can differentiate between the annotation types by specifying different reuse identifiers for each one. */
28 | @property (nonatomic, readonly) NSString *reuseIdentifier;
29 | 
30 | /** A Boolean value indicating whether the annotation is enabled.
31 | *
32 | *   The default value of this property is `YES`. If the value of this property is `NO`, the annotation image ignores touch events and cannot be selected. */
33 | @property (nonatomic, getter=isEnabled) BOOL enabled;
34 | 
35 | @end
36 | 
37 | NS_ASSUME_NONNULL_END
38 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLGeometry.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | #import <CoreLocation/CoreLocation.h>
 3 | #import <CoreGraphics/CGBase.h>
 4 | 
 5 | #import "MGLTypes.h"
 6 | 
 7 | NS_ASSUME_NONNULL_BEGIN
 8 | 
 9 | /** Defines the area spanned by an MGLCoordinateBounds. */
10 | typedef struct {
11 |     CLLocationDegrees latitudeDelta;
12 |     CLLocationDegrees longitudeDelta;
13 | } MGLCoordinateSpan;
14 | 
15 | /** Creates a new MGLCoordinateSpan from the given latitudinal and longitudinal deltas. */
16 | NS_INLINE MGLCoordinateSpan MGLCoordinateSpanMake(CLLocationDegrees latitudeDelta, CLLocationDegrees longitudeDelta) {
17 |     MGLCoordinateSpan span;
18 |     span.latitudeDelta = latitudeDelta;
19 |     span.longitudeDelta = longitudeDelta;
20 |     return span;
21 | }
22 | 
23 | /** Returns `YES` if the two coordinate spans represent the same latitudinal change and the same longitudinal change. */
24 | NS_INLINE BOOL MGLCoordinateSpanEqualToCoordinateSpan(MGLCoordinateSpan span1, MGLCoordinateSpan span2) {
25 |     return (span1.latitudeDelta == span2.latitudeDelta &&
26 |             span1.longitudeDelta == span2.longitudeDelta);
27 | }
28 | 
29 | /** An area of zero width and zero height. */
30 | extern const MGLCoordinateSpan MGLCoordinateSpanZero;
31 | 
32 | /** A rectangular area as measured on a two-dimensional map projection. */
33 | typedef struct {
34 |     CLLocationCoordinate2D sw;
35 |     CLLocationCoordinate2D ne;
36 | } MGLCoordinateBounds;
37 | 
38 | /** Creates a new MGLCoordinateBounds structure from the given southwest and northeast coordinates. */
39 | NS_INLINE MGLCoordinateBounds MGLCoordinateBoundsMake(CLLocationCoordinate2D sw, CLLocationCoordinate2D ne) {
40 |     MGLCoordinateBounds bounds;
41 |     bounds.sw = sw;
42 |     bounds.ne = ne;
43 |     return bounds;
44 | }
45 | 
46 | /** Returns `YES` if the two coordinate bounds are equal to each other. */
47 | NS_INLINE BOOL MGLCoordinateBoundsEqualToCoordinateBounds(MGLCoordinateBounds bounds1, MGLCoordinateBounds bounds2) {
48 |     return (bounds1.sw.latitude == bounds2.sw.latitude &&
49 |             bounds1.sw.longitude == bounds2.sw.longitude &&
50 |             bounds1.ne.latitude == bounds2.ne.latitude &&
51 |             bounds1.ne.longitude == bounds2.ne.longitude);
52 | }
53 | 
54 | /** Returns the area spanned by the coordinate bounds. */
55 | NS_INLINE MGLCoordinateSpan MGLCoordinateBoundsGetCoordinateSpan(MGLCoordinateBounds bounds) {
56 |     return MGLCoordinateSpanMake(bounds.ne.latitude - bounds.sw.latitude,
57 |                                  bounds.ne.longitude - bounds.sw.longitude);
58 | }
59 | 
60 | /** Returns a coordinate bounds with southwest and northeast coordinates that are offset from those of the source bounds. */
61 | NS_INLINE MGLCoordinateBounds MGLCoordinateBoundsOffset(MGLCoordinateBounds bounds, MGLCoordinateSpan offset) {
62 |     MGLCoordinateBounds offsetBounds = bounds;
63 |     offsetBounds.sw.latitude += offset.latitudeDelta;
64 |     offsetBounds.sw.longitude += offset.longitudeDelta;
65 |     offsetBounds.ne.latitude += offset.latitudeDelta;
66 |     offsetBounds.ne.longitude += offset.longitudeDelta;
67 |     return offsetBounds;
68 | }
69 | 
70 | /** Returns `YES` if the coordinate bounds covers no area.
71 | *   
72 | *   Note that a bounds may be empty but have a non-zero coordinate span (e.g., when its northeast point lies due north of its southwest point). */
73 | NS_INLINE BOOL MGLCoordinateBoundsIsEmpty(MGLCoordinateBounds bounds) {
74 |     MGLCoordinateSpan span = MGLCoordinateBoundsGetCoordinateSpan(bounds);
75 |     return span.latitudeDelta == 0 || span.longitudeDelta == 0;
76 | }
77 | 
78 | /** Returns a formatted string for the given coordinate bounds. */
79 | NS_INLINE NSString *MGLStringFromCoordinateBounds(MGLCoordinateBounds bounds) {
80 |     return [NSString stringWithFormat:@"{{%.1f, %.1f}, {%.1f, %.1f}}",
81 |             bounds.sw.latitude, bounds.sw.longitude,
82 |             bounds.ne.latitude, bounds.ne.longitude];
83 | }
84 | 
85 | /** Returns radians, converted from degrees. */
86 | NS_INLINE CGFloat MGLRadiansFromDegrees(CLLocationDegrees degrees)
87 | {
88 |     return (CGFloat)(degrees * M_PI) / 180;
89 | }
90 | 
91 | /** Returns degrees, converted from radians. */
92 | NS_INLINE CLLocationDegrees MGLDegreesFromRadians(CGFloat radians)
93 | {
94 |     return radians * 180 / M_PI;
95 | }
96 | 
97 | NS_ASSUME_NONNULL_END
98 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLMapCamera.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | #import <CoreGraphics/CoreGraphics.h>
 3 | #import <CoreLocation/CoreLocation.h>
 4 | 
 5 | #import "MGLTypes.h"
 6 | 
 7 | NS_ASSUME_NONNULL_BEGIN
 8 | 
 9 | /** An `MGLMapCamera` object represents a viewpoint from which the user observes some point on an `MGLMapView`. */
10 | @interface MGLMapCamera : NSObject <NSSecureCoding, NSCopying>
11 | 
12 | /** Coordinate at the center of the map view. */
13 | @property (nonatomic) CLLocationCoordinate2D centerCoordinate;
14 | 
15 | /** Heading measured in degrees clockwise from true north. */
16 | @property (nonatomic) CLLocationDirection heading;
17 | 
18 | /** Pitch toward the horizon measured in degrees, with 0 degrees resulting in a two-dimensional map. */
19 | @property (nonatomic) CGFloat pitch;
20 | 
21 | /** Meters above ground level. */
22 | @property (nonatomic) CLLocationDistance altitude;
23 | 
24 | /** Returns a new camera with all properties set to 0. */
25 | + (instancetype)camera;
26 | 
27 | + (instancetype)cameraLookingAtCenterCoordinate:(CLLocationCoordinate2D)centerCoordinate
28 |                               fromEyeCoordinate:(CLLocationCoordinate2D)eyeCoordinate
29 |                                     eyeAltitude:(CLLocationDistance)eyeAltitude;
30 | 
31 | + (instancetype)cameraLookingAtCenterCoordinate:(CLLocationCoordinate2D)centerCoordinate
32 |                                    fromDistance:(CLLocationDistance)distance
33 |                                           pitch:(CGFloat)pitch
34 |                                         heading:(CLLocationDirection)heading;
35 | 
36 | @end
37 | 
38 | NS_ASSUME_NONNULL_END
39 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLMapView+IBAdditions.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | 
 3 | #import "MGLTypes.h"
 4 | 
 5 | @class MGLMapView;
 6 | 
 7 | NS_ASSUME_NONNULL_BEGIN
 8 | 
 9 | @interface MGLMapView (IBAdditions)
10 | 
11 | // Core properties that can be manipulated in the Attributes inspector in
12 | // Interface Builder. These redeclarations merely add the IBInspectable keyword.
13 | // They appear here to ensure that they appear above the convenience properties;
14 | // inspectables declared in MGLMapView.h are always sorted before those in
15 | // MGLMapView+IBAdditions.h, due to ASCII sort order.
16 | 
17 | #if TARGET_INTERFACE_BUILDER
18 | 
19 | // HACK: We want this property to look like a URL bar in the Attributes
20 | // inspector, but just calling it styleURL would violate Cocoa naming
21 | // conventions and conflict with the existing NSURL property. Fortunately, IB
22 | // strips out the two underscores for display.
23 | @property (nonatomic, nullable) IBInspectable NSString *styleURL__;
24 | 
25 | #endif // TARGET_INTERFACE_BUILDER
26 | 
27 | // Convenience properties related to the initial viewport. These properties
28 | // are not meant to be used outside of Interface Builder. latitude and longitude
29 | // are backed by properties of type CLLocationDegrees, but these declarations
30 | // must use the type double because Interface Builder is unaware that
31 | // CLLocationDegrees is a typedef for double.
32 | 
33 | @property (nonatomic) IBInspectable double latitude;
34 | @property (nonatomic) IBInspectable double longitude;
35 | @property (nonatomic) IBInspectable double zoomLevel;
36 | 
37 | // Renamed properties. Interface Builder derives the display name of each
38 | // inspectable from the runtime name, but runtime names don’t always make sense
39 | // in UI.
40 | 
41 | @property (nonatomic) IBInspectable BOOL allowsZooming;
42 | @property (nonatomic) IBInspectable BOOL allowsScrolling;
43 | @property (nonatomic) IBInspectable BOOL allowsRotating;
44 | @property (nonatomic) IBInspectable BOOL allowsTilting;
45 | @property (nonatomic) IBInspectable BOOL showsUserLocation;
46 | 
47 | @end
48 | 
49 | NS_ASSUME_NONNULL_END
50 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLMapView.h:
--------------------------------------------------------------------------------
  1 | #import "MGLGeometry.h"
  2 | #import "MGLMapCamera.h"
  3 | 
  4 | #import <UIKit/UIKit.h>
  5 | #import <CoreLocation/CoreLocation.h>
  6 | 
  7 | #import "MGLTypes.h"
  8 | 
  9 | NS_ASSUME_NONNULL_BEGIN
 10 | 
 11 | @class MGLAnnotationImage;
 12 | @class MGLUserLocation;
 13 | @class MGLPolyline;
 14 | @class MGLPolygon;
 15 | @class MGLShape;
 16 | 
 17 | @protocol MGLMapViewDelegate;
 18 | @protocol MGLAnnotation;
 19 | @protocol MGLOverlay;
 20 | 
 21 | /** An MGLMapView object provides an embeddable map interface, similar to the one provided by Apple's MapKit. You use this class to display map information and to manipulate the map contents from your application. You can center the map on a given coordinate, specify the size of the area you want to display, and style the features of the map to fit your application's use case.
 22 | *
 23 | *   Use of MGLMapView requires a Mapbox API access token. Obtain an access token on the [Mapbox account page](https://www.mapbox.com/account/apps/). If you instantiate an MGLMapView from Interface Builder, rendering of the map won't begin until the accessToken property has been set.
 24 | *
 25 | *   @warning Please note that you are responsible for getting permission to use the map data, and for ensuring your use adheres to the relevant terms of use. */
 26 | IB_DESIGNABLE
 27 | @interface MGLMapView : UIView
 28 | 
 29 | #pragma mark - Initializing a Map View
 30 | 
 31 | /** @name Initializing a Map View */
 32 | 
 33 | /** Initializes and returns a newly allocated map view with the specified frame and the default style.
 34 | *   @param frame The frame for the view, measured in points.
 35 | *   @return An initialized map view. */
 36 | - (instancetype)initWithFrame:(CGRect)frame;
 37 | 
 38 | /** Initializes and returns a newly allocated map view with the specified frame and style URL.
 39 | *   @param frame The frame for the view, measured in points.
 40 | *   @param styleURL The map style URL to use. Can be either an HTTP/HTTPS URL or a Mapbox map ID style URL (`mapbox://styles/<user>/<style>`). Specify `nil` for the default style.
 41 | *   @return An initialized map view. */
 42 | - (instancetype)initWithFrame:(CGRect)frame styleURL:(nullable NSURL *)styleURL;
 43 | 
 44 | #pragma mark - Accessing Map Properties
 45 | 
 46 | /** @name Accessing Map Properties */
 47 | 
 48 | /** A Boolean value that determines whether the user may zoom the map.
 49 | *
 50 | *   This property controls only user interactions with the map. If you set the value of this property to `NO`, you may still change the map zoom programmatically.
 51 | *
 52 | *   The default value of this property is `YES`. */
 53 | @property(nonatomic, getter=isZoomEnabled) BOOL zoomEnabled;
 54 | 
 55 | /** A Boolean value that determines whether the user may scroll around the map.
 56 | *
 57 | *   This property controls only user interactions with the map. If you set the value of this property to `NO`, you may still change the map location programmatically.
 58 | *
 59 | *   The default value of this property is `YES`. */
 60 | @property(nonatomic, getter=isScrollEnabled) BOOL scrollEnabled;
 61 | 
 62 | /** A Boolean value that determines whether the user may rotate the map.
 63 | *
 64 | *   This property controls only user interactions with the map. If you set the value of this property to `NO`, you may still rotate the map programmatically.
 65 | *
 66 | *   The default value of this property is `YES`. */
 67 | @property(nonatomic, getter=isRotateEnabled) BOOL rotateEnabled;
 68 | 
 69 | /** A Boolean value that determines whether the user may change the pitch (tilt) of the map.
 70 |  *
 71 |  *   This property controls only user interactions with the map. If you set the value of this property to `NO`, you may still change the pitch of the map programmatically.
 72 |  *
 73 |  *   The default value of this property is `YES`. */
 74 | @property(nonatomic, getter=isPitchEnabled) BOOL pitchEnabled;
 75 | 
 76 | /** The compass image view shown in the upper-right when the map is rotated. */
 77 | @property (nonatomic, readonly) UIImageView *compassView;
 78 | 
 79 | /** The Mapbox logo image view shown in the lower-left of the map. */
 80 | @property (nonatomic, readonly) UIImageView *logoView;
 81 | 
 82 | /** The button shown in the lower-right of the map which when pressed displays the map attribution information. */
 83 | @property (nonatomic, readonly) UIButton *attributionButton;
 84 | 
 85 | #pragma mark - Accessing the Delegate
 86 | 
 87 | /** @name Accessing the Delegate */
 88 | 
 89 | // TODO
 90 | @property(nonatomic, weak, nullable) IBOutlet id<MGLMapViewDelegate> delegate;
 91 | 
 92 | #pragma mark - Manipulating the Visible Portion of the Map
 93 | 
 94 | /** @name Manipulating the Visible Portion of the Map */
 95 | 
 96 | /** The map coordinate at the center of the map view.
 97 | *
 98 | *   Changing the value in this property centers the map on the new coordinate without changing the current zoom level. 
 99 | *
100 | *   Changing the value of this property updates the map view immediately. If you want to animate the change, use the setCenterCoordinate:animated: method instead. */
101 | @property (nonatomic) CLLocationCoordinate2D centerCoordinate;
102 | 
103 | /** Changes the center coordinate of the map and optionally animates the change.
104 | *   @param coordinate The new center coordinate for the map.
105 | *   @param animated Specify `YES` if you want the map view to scroll to the new location or `NO` if you want the map to display the new location immediately.
106 | *
107 | *   Changing the center coordinate centers the map on the new coordinate without changing the current zoom level. */
108 | - (void)setCenterCoordinate:(CLLocationCoordinate2D)coordinate animated:(BOOL)animated;
109 | 
110 | /** The zoom level of the map view.
111 | *
112 | *   Changing the value in this property zooms the map in or out without changing the center coordinate. At zoom level 0, tiles cover the entire world map; at zoom level 1, tiles cover 1/4 of the world; at zoom level 2, tiles cover 1/16 of the world, and so on.
113 | *
114 | *   Changing the value of this property updates the map view immediately. If you want to animate the change, use the setZoomLevel:animated: method instead. */
115 | @property (nonatomic) double zoomLevel;
116 | 
117 | /** Changes the zoom level of the map and optionally animates the change.
118 | *   @param zoomLevel The new zoom level for the map.
119 | *   @param animated Specify `YES` if you want the map view to animate the change to the new zoom level or `NO` if you want the map to display the new zoom level immediately.
120 | *
121 | *   Changing the zoom level scales the map without changing the current center coordinate. At zoom level 0, tiles cover the entire world map; at zoom level 1, tiles cover 1/4 of the world; at zoom level 2, tiles cover 1/16 of the world, and so on. */
122 | - (void)setZoomLevel:(double)zoomLevel animated:(BOOL)animated;
123 | 
124 | /** Changes the center coordinate and zoom level of the map and optionally animates the change. 
125 | *   @param centerCoordinate The new center coordinate for the map.
126 | *   @param zoomLevel The new zoom level for the map.
127 | *   @param animated Specify `YES` if you want the map view to animate scrolling and zooming to the new location or `NO` if you want the map to display the new location immediately. */
128 | - (void)setCenterCoordinate:(CLLocationCoordinate2D)centerCoordinate zoomLevel:(double)zoomLevel animated:(BOOL)animated;
129 | 
130 | /** Changes the center coordinate, zoom level, and direction of the map and optionally animates the change. 
131 | *   @param centerCoordinate The new center coordinate for the map.
132 | *   @param zoomLevel The new zoom level for the map.
133 | *   @param direction The new direction for the map, measured in degrees relative to true north.
134 | *   @param animated Specify `YES` if you want the map view to animate scrolling, zooming, and rotating to the new location or `NO` if you want the map to display the new location immediately. */
135 | - (void)setCenterCoordinate:(CLLocationCoordinate2D)centerCoordinate zoomLevel:(double)zoomLevel direction:(CLLocationDirection)direction animated:(BOOL)animated;
136 | 
137 | /** The coordinate bounds visible in the receiver’s viewport.
138 | *   
139 | *   Changing the value of this property updates the receiver immediately. If you want to animate the change, call `setVisibleCoordinateBounds:animated:` instead. */
140 | @property (nonatomic) MGLCoordinateBounds visibleCoordinateBounds;
141 | 
142 | /** Changes the receiver’s viewport to fit the given coordinate bounds, optionally animating the change.
143 | *   @param bounds The bounds that the viewport will show in its entirety.
144 | *   @param animated Specify `YES` to animate the change by smoothly scrolling and zooming or `NO` to immediately display the given bounds. */
145 | - (void)setVisibleCoordinateBounds:(MGLCoordinateBounds)bounds animated:(BOOL)animated;
146 | 
147 | /** Changes the receiver’s viewport to fit the given coordinate bounds and optionally some additional padding on each side.
148 | *   @param bounds The bounds that the viewport will show in its entirety.
149 | *   @param insets The minimum padding (in screen points) that will be visible around the given coordinate bounds.
150 | *   @param animated Specify `YES` to animate the change by smoothly scrolling and zooming or `NO` to immediately display the given bounds. */
151 | - (void)setVisibleCoordinateBounds:(MGLCoordinateBounds)bounds edgePadding:(UIEdgeInsets)insets animated:(BOOL)animated;
152 | 
153 | /** Changes the receiver’s viewport to fit all of the given coordinates and optionally some additional padding on each side.
154 | *   @param coordinates The coordinates that the viewport will show.
155 | *   @param count The number of coordinates. This number must not be greater than the number of elements in `coordinates`.
156 | *   @param insets The minimum padding (in screen points) that will be visible around the given coordinate bounds.
157 | *   @param animated Specify `YES` to animate the change by smoothly scrolling and zooming or `NO` to immediately display the given bounds. */
158 | - (void)setVisibleCoordinates:(CLLocationCoordinate2D *)coordinates count:(NSUInteger)count edgePadding:(UIEdgeInsets)insets animated:(BOOL)animated;
159 | 
160 | /** Sets the visible region so that the map displays the specified annotations.
161 | *
162 | *   Calling this method updates the value in the visibleCoordinateBounds property and potentially other properties to reflect the new map region.
163 | *   @param annotations The annotations that you want to be visible in the map.
164 | *   @param animated `YES` if you want the map region change to be animated, or `NO` if you want the map to display the new region immediately without animations. */
165 | - (void)showAnnotations:(NS_ARRAY_OF(id <MGLAnnotation>) *)annotations animated:(BOOL)animated;
166 | 
167 | /** The heading of the map (measured in degrees) relative to true north. 
168 | *
169 | *   The value `0` means that the top edge of the map view corresponds to true north. The value `90` means the top of the map is pointing due east. The value `180` means the top of the map points due south, and so on. */
170 | @property (nonatomic) CLLocationDirection direction;
171 | 
172 | /** Changes the heading of the map and optionally animates the changes.
173 | *   @param direction The heading of the map (measured in degrees) relative to true north.
174 | *   @param animated Specify `YES` if you want the map view to animate the change to the new heading or `NO` if you want the map to display the new heading immediately. 
175 | *
176 | *   Changing the heading rotates the map without changing the current center coordinate or zoom level. */
177 | - (void)setDirection:(CLLocationDirection)direction animated:(BOOL)animated;
178 | 
179 | /** Resets the map rotation to a northern heading. */
180 | - (IBAction)resetNorth;
181 | 
182 | /** A camera representing the current viewpoint of the map. */
183 | @property (nonatomic, copy) MGLMapCamera *camera;
184 | 
185 | /** Moves the viewpoint to a different location with respect to the map with an optional transition animation.
186 | *   @param camera The new viewpoint.
187 | *   @param animated Specify `YES` if you want the map view to animate the change to the new viewpoint or `NO` if you want the map to display the new viewpoint immediately. */
188 | - (void)setCamera:(MGLMapCamera *)camera animated:(BOOL)animated;
189 | 
190 | /** Moves the viewpoint to a different location with respect to the map with an optional transition duration and timing function.
191 | *   @param camera The new viewpoint.
192 | *   @param duration The amount of time, measured in seconds, that the transition animation should take. Specify `0` to jump to the new viewpoint instantaneously.
193 | *   @param function A timing function used for the animation. Set this parameter to `nil` for a transition that matches most system animations. If the duration is `0`, this parameter is ignored. */
194 | - (void)setCamera:(MGLMapCamera *)camera withDuration:(NSTimeInterval)duration animationTimingFunction:(nullable CAMediaTimingFunction *)function;
195 | 
196 | #pragma mark - Converting Map Coordinates
197 | 
198 | /** @name Converting Map Coordinates */
199 | 
200 | /** Converts a point in the specified view’s coordinate system to a map coordinate.
201 | *   @param point The point you want to convert.
202 | *   @param view The view that serves as the reference coordinate system for the `point` parameter.
203 | *   @return The map coordinate at the specified point. */
204 | - (CLLocationCoordinate2D)convertPoint:(CGPoint)point toCoordinateFromView:(nullable UIView *)view;
205 | 
206 | /** Converts a map coordinate to a point in the specified view.
207 | *   @param coordinate The map coordinate for which you want to find the corresponding point.
208 | *   @param view The view in whose coordinate system you want to locate the specified map coordinate. If this parameter is `nil`, the returned point is specified in the window’s coordinate system. If `view` is not `nil`, it must belong to the same window as the map view.
209 | *   @return The point (in the appropriate view or window coordinate system) corresponding to the specified latitude and longitude value. */
210 | - (CGPoint)convertCoordinate:(CLLocationCoordinate2D)coordinate toPointToView:(nullable UIView *)view;
211 | 
212 | /** Returns the distance spanned by one pixel at the specified latitude and current zoom level.
213 | *
214 | *   The distance between pixels decreases as the latitude approaches the poles. This relationship parallels the relationship between longitudinal coordinates at different latitudes.
215 | *
216 | *   @param latitude The latitude for which to return the value.
217 | *   @return The distance (in meters) spanned by a single pixel. */
218 | - (CLLocationDistance)metersPerPixelAtLatitude:(CLLocationDegrees)latitude;
219 | 
220 | #pragma mark - Styling the Map
221 | 
222 | /** @name Styling the Map */
223 | 
224 | @property (nonatomic, nullable) NSString *styleID __attribute__((unavailable("Set styleURL to an NSURL of the form <mapbox://styles/STYLE_ID>, where STYLE_ID would have been the value of this property.")));
225 | 
226 | /** URLs of the styles bundled with the library.
227 |     @deprecated Call the relevant class method of `MGLStyle` for the URL of a particular default style. */
228 | @property (nonatomic, readonly) NS_ARRAY_OF(NSURL *) *bundledStyleURLs __attribute__((deprecated("Call the relevant class method of MGLStyle for the URL of a particular default style.")));
229 | 
230 | /** URL of the style currently displayed in the receiver.
231 | *
232 | *   The URL may be a full HTTP or HTTPS URL or a Mapbox URL indicating the style’s map ID (`mapbox://styles/<user>/<style>`).
233 | *
234 | *   To display the default style, set this property to `nil`. */
235 | @property (nonatomic, null_resettable) NSURL *styleURL;
236 | 
237 | /** Currently active style classes, represented as an array of string identifiers. */
238 | @property (nonatomic) NS_ARRAY_OF(NSString *) *styleClasses;
239 | 
240 | /** Returns a Boolean value indicating whether the style class with the given identifier is currently active.
241 |     @param styleClass The style class to query for.
242 |     @return Whether the style class is currently active. */
243 | - (BOOL)hasStyleClass:(NSString *)styleClass;
244 | 
245 | /** Activates the style class with the given identifier.
246 |     @param styleClass The style class to activate. */
247 | - (void)addStyleClass:(NSString *)styleClass;
248 | 
249 | /** Deactivates the style class with the given identifier. 
250 |     @param styleClass The style class to deactivate. */
251 | - (void)removeStyleClass:(NSString *)styleClass;
252 | 
253 | #pragma mark - Annotating the Map
254 | 
255 | /** @name Annotating the Map */
256 | 
257 | /** The complete list of annotations associated with the receiver. (read-only)
258 | *
259 | *   The objects in this array must adopt the MGLAnnotation protocol. If no annotations are associated with the map view, the value of this property is `nil`. */
260 | @property (nonatomic, readonly, nullable) NS_ARRAY_OF(id <MGLAnnotation>) *annotations;
261 | 
262 | /** Adds the specified annotation to the map view.
263 | *   @param annotation The annotation object to add to the receiver. This object must conform to the MGLAnnotation protocol. The map view retains the specified object. */
264 | - (void)addAnnotation:(id <MGLAnnotation>)annotation;
265 | 
266 | /** Adds an array of annotation objects to the map view.
267 | *   @param annotations An array of annotation objects. Each object in the array must conform to the MGLAnnotation protocol. The map view retains the individual annotation objects. */
268 | - (void)addAnnotations:(NS_ARRAY_OF(id <MGLAnnotation>) *)annotations;
269 | 
270 | /** Removes the specified annotation object from the map view.
271 | *
272 | *   Removing an annotation object disassociates it from the map view entirely, preventing it from being displayed on the map. Thus, you would typically call this method only when you want to hide or delete a given annotation.
273 | *
274 | *   @param annotation The annotation object to remove. This object must conform to the MGLAnnotation protocol. */
275 | - (void)removeAnnotation:(id <MGLAnnotation>)annotation;
276 | 
277 | /** Removes an array of annotation objects from the map view.
278 | *
279 | *   Removing annotation objects disassociates them from the map view entirely, preventing them from being displayed on the map. Thus, you would typically call this method only when you want to hide or delete the specified annotations.
280 | *
281 | *   @param annotations The array of annotations to remove. Objects in the array must conform to the MGLAnnotation protocol. */
282 | - (void)removeAnnotations:(NS_ARRAY_OF(id <MGLAnnotation>) *)annotations;
283 | 
284 | /** Returns a reusable annotation image object located by its identifier.
285 | *
286 | *   For performance reasons, you should generally reuse MGLAnnotationImage objects for annotations in your map views. Dequeueing saves time and memory during performance-critical operations such as scrolling.
287 | *
288 | *   @param identifier A string identifying the annotation image to be reused. This string is the same one you specify when initially returning the annotation image object using the mapView:imageForAnnotation: method.
289 | *   @return An annotation image object with the specified identifier, or `nil` if no such object exists in the reuse queue. */
290 | - (nullable MGLAnnotationImage *)dequeueReusableAnnotationImageWithIdentifier:(NSString *)identifier;
291 | 
292 | #pragma mark - Managing Annotation Selections
293 | 
294 | /** @name Managing Annotation Selections */
295 | 
296 | /** The annotations that are currently selected.
297 | *
298 | *   Assigning a new array to this property selects only the first annotation in the array. */
299 | @property (nonatomic, copy) NS_ARRAY_OF(id <MGLAnnotation>) *selectedAnnotations;
300 | 
301 | /** Selects the specified annotation and displays a callout view for it.
302 | *
303 | *   If the specified annotation is not onscreen, this method has no effect.
304 | *
305 | *   @param annotation The annotation object to select.
306 | *   @param animated If `YES`, the callout view is animated into position. */
307 | - (void)selectAnnotation:(id <MGLAnnotation>)annotation animated:(BOOL)animated;
308 | 
309 | /** Deselects the specified annotation and hides its callout view.
310 | *   @param annotation The annotation object to deselect.
311 | *   @param animated If `YES`, the callout view is animated offscreen. */
312 | - (void)deselectAnnotation:(id <MGLAnnotation>)annotation animated:(BOOL)animated;
313 | 
314 | #pragma mark - Adding Overlays
315 | 
316 | /** @name Adding Overlays */
317 | 
318 | /** Adds a single overlay object to the map.
319 | *
320 | *   To remove an overlay from a map, use the removeOverlay: method.
321 | *   @param overlay The overlay object to add. This object must conform to the MGLOverlay protocol. */
322 | - (void)addOverlay:(id <MGLOverlay>)overlay;
323 | 
324 | /** Adds an array of overlay objects to the map.
325 | *
326 | *   To remove multiple overlays from a map, use the removeOverlays: method.
327 | *   @param overlays An array of objects, each of which must conform to the MGLOverlay protocol. */
328 | - (void)addOverlays:(NS_ARRAY_OF(id <MGLOverlay>) *)overlays;
329 | 
330 | #pragma mark - Removing Overlays
331 | 
332 | /** @name Removing Overlays */
333 | 
334 | /** Removes a single overlay object from the map.
335 | *
336 | *   If the specified overlay is not currently associated with the map view, this method does nothing.
337 | *   @param overlay The overlay object to remove. */
338 | - (void)removeOverlay:(id <MGLOverlay>)overlay;
339 | 
340 | /** Removes one or more overlay objects from the map.
341 | *
342 | *   If a given overlay object is not associated with the map view, it is ignored.
343 | *   @param overlays An array of objects, each of which conforms to the MGLOverlay protocol. */
344 | - (void)removeOverlays:(NS_ARRAY_OF(id <MGLOverlay>) *)overlays;
345 | 
346 | #pragma mark - Displaying the User's Location
347 | 
348 | /** @name Displaying the User's Location */
349 | 
350 | /** A Boolean value indicating whether the map may display the user location.
351 | *
352 | *   This property does not indicate whether the user’s position is actually visible on the map, only whether the map view is allowed to display it. To determine whether the user’s position is visible, use the userLocationVisible property. The default value of this property is `NO`.
353 | *
354 | *   Setting this property to `YES` causes the map view to use the Core Location framework to find the current location. As long as this property is `YES`, the map view continues to track the user’s location and update it periodically.
355 | *
356 | *   On iOS 8 and above, your app must specify a value for `NSLocationWhenInUseUsageDescription` or `NSLocationAlwaysUsageDescription` in its `Info.plist` to satisfy the requirements of the underlying Core Location framework when enabling this property. */
357 | @property (nonatomic, assign) BOOL showsUserLocation;
358 | 
359 | /** A Boolean value indicating whether the device’s current location is visible in the map view. (read-only) */
360 | @property (nonatomic, assign, readonly, getter=isUserLocationVisible) BOOL userLocationVisible;
361 | 
362 | /** Returns the annotation object indicating the user’s current location. */
363 | @property (nonatomic, readonly, nullable) MGLUserLocation *userLocation;
364 | 
365 | /** The mode used to track the user location. */
366 | @property (nonatomic, assign) MGLUserTrackingMode userTrackingMode;
367 | 
368 | /** Whether the map view should display a heading calibration alert when necessary. The default value is `YES`. */
369 | @property (nonatomic, assign) BOOL displayHeadingCalibration;
370 | 
371 | #pragma mark - Debugging
372 | 
373 | /** @name Debugging */
374 | 
375 | /** A Boolean value that determines whether map debugging information is shown. 
376 | *
377 | *   The default value of this property is `NO`. */
378 | @property (nonatomic, getter=isDebugActive) BOOL debugActive;
379 | 
380 | /** Toggle the current value of debugActive. */
381 | - (void)toggleDebug;
382 | 
383 | /** Empties the in-memory tile cache. */
384 | - (void)emptyMemoryCache;
385 | 
386 | /** Resets the map to the minimum zoom level, a center coordinate of (0, 0), and a northern heading. */
387 | - (void)resetPosition;
388 | 
389 | @end
390 | 
391 | #pragma mark - MGLMapViewDelegate
392 | 
393 | /** The MGLMapViewDelegate protocol defines a set of optional methods that you can use to receive map-related update messages. Because many map operations require the MGLMapView class to load data asynchronously, the map view calls these methods to notify your application when specific operations complete. The map view also uses these methods to request annotation marker symbology and to manage interactions with those markers. */
394 | @protocol MGLMapViewDelegate <NSObject>
395 | 
396 | @optional
397 | 
398 | #pragma mark - Responding to Map Position Changes
399 | 
400 | /** @name Responding to Map Position Changes */
401 | 
402 | /** Tells the delegate that the region displayed by the map view is about to change.
403 |  *
404 |  *   This method is called whenever the currently displayed map region will start changing.
405 |  *   @param mapView The map view whose visible region will change.
406 |  *   @param animated Whether the change will cause an animated effect on the map. */
407 | - (void)mapView:(MGLMapView *)mapView regionWillChangeAnimated:(BOOL)animated;
408 | 
409 | /** Tells the delegate that the region displayed by the map view is changing.
410 |  *
411 |  *   This method is called whenever the currently displayed map region changes. During movement, this method may be called many times to report updates to the map position. Therefore, your implementation of this method should be as lightweight as possible to avoid affecting performance.
412 |  *   @param mapView The map view whose visible region is changing. */
413 | - (void)mapViewRegionIsChanging:(MGLMapView *)mapView;
414 | 
415 | /** Tells the delegate that the region displayed by the map view just changed.
416 |  *
417 |  *   This method is called whenever the currently displayed map region has finished changing.
418 |  *   @param mapView The map view whose visible region changed.
419 |  *   @param animated Whether the change caused an animated effect on the map. */
420 | - (void)mapView:(MGLMapView *)mapView regionDidChangeAnimated:(BOOL)animated;
421 | 
422 | #pragma mark - Loading the Map
423 | 
424 | /** @name Loading the Map */
425 | 
426 | /** Tells the delegate that the map view will begin to load.
427 |  *
428 |  *   This method is called whenever the map view starts loading, including when a new style has been set and the map must reload.
429 |  *   @param mapView The map view that is starting to load. */
430 | - (void)mapViewWillStartLoadingMap:(MGLMapView *)mapView;
431 | 
432 | /** Tells the delegate that the map view has finished loading.
433 |  *
434 |  *   This method is called whenever the map view finishes loading, either after the initial load or after a style change has forced a reload.
435 |  *   @param mapView The map view that has finished loading. */
436 | - (void)mapViewDidFinishLoadingMap:(MGLMapView *)mapView;
437 | 
438 | // TODO
439 | - (void)mapViewDidFailLoadingMap:(MGLMapView *)mapView withError:(NSError *)error;
440 | 
441 | // TODO
442 | - (void)mapViewWillStartRenderingMap:(MGLMapView *)mapView;
443 | 
444 | // TODO
445 | - (void)mapViewDidFinishRenderingMap:(MGLMapView *)mapView fullyRendered:(BOOL)fullyRendered;
446 | 
447 | // TODO
448 | - (void)mapViewWillStartRenderingFrame:(MGLMapView *)mapView;
449 | 
450 | // TODO
451 | - (void)mapViewDidFinishRenderingFrame:(MGLMapView *)mapView fullyRendered:(BOOL)fullyRendered;
452 | 
453 | #pragma mark - Tracking User Location
454 | 
455 | /** @name Tracking User Location */
456 | 
457 | /** Tells the delegate that the map view will begin tracking the user’s location.
458 |  *
459 |  *   This method is called when the value of the showsUserLocation property changes to `YES`.
460 |  *
461 |  *   @param mapView The map view that is tracking the user’s location. */
462 | - (void)mapViewWillStartLocatingUser:(MGLMapView *)mapView;
463 | 
464 | /** Tells the delegate that the map view has stopped tracking the user’s location.
465 |  *
466 |  *   This method is called when the value of the showsUserLocation property changes to `NO`.
467 |  *
468 |  *   @param mapView The map view that is tracking the user’s location. */
469 | - (void)mapViewDidStopLocatingUser:(MGLMapView *)mapView;
470 | 
471 | /** Tells the delegate that the location of the user was updated.
472 |  *
473 |  *   While the showsUserLocation property is set to `YES`, this method is called whenever a new location update is received by the map view. This method is also called if the map view’s user tracking mode is set to MGLUserTrackingModeFollowWithHeading and the heading changes, or if it is set to MGLUserTrackingModeFollowWithCourse and the course changes.
474 |  *
475 |  *   This method is not called if the application is currently running in the background. If you want to receive location updates while running in the background, you must use the Core Location framework.
476 |  *
477 |  *   @param mapView The map view that is tracking the user’s location.
478 |  *   @param userLocation The location object representing the user’s latest location. This property may be `nil`. */
479 | - (void)mapView:(MGLMapView *)mapView didUpdateUserLocation:(nullable MGLUserLocation *)userLocation;
480 | 
481 | /** Tells the delegate that an attempt to locate the user’s position failed.
482 |  *   @param mapView The map view that is tracking the user’s location.
483 |  *   @param error An error object containing the reason why location tracking failed. */
484 | - (void)mapView:(MGLMapView *)mapView didFailToLocateUserWithError:(NSError *)error;
485 | 
486 | /** Tells the delegate that the map view’s user tracking mode has changed.
487 |  *
488 |  *   This method is called after the map view asynchronously changes to reflect the new user tracking mode, for example by beginning to zoom or rotate.
489 |  *
490 |  *   @param mapView The map view that changed its tracking mode.
491 |  *   @param mode The new tracking mode.
492 |  *   @param animated Whether the change caused an animated effect on the map. */
493 | - (void)mapView:(MGLMapView *)mapView didChangeUserTrackingMode:(MGLUserTrackingMode)mode animated:(BOOL)animated;
494 | 
495 | #pragma mark - Managing the Display of Annotations
496 | 
497 | /** @name Managing the Display of Annotations */
498 | 
499 | - (nullable NSString *)mapView:(MGLMapView *)mapView symbolNameForAnnotation:(id <MGLAnnotation>)annotation __attribute__((unavailable("Use -mapView:imageForAnnotation:.")));
500 | 
501 | /** Returns an image object to use for the marker for the specified point annotation object.
502 | *   @param mapView The map view that requested the annotation image.
503 | *   @param annotation The object representing the annotation that is about to be displayed.
504 | *   @return The image object to display for the specified annotation or `nil` if you want to display the default marker image. */
505 | - (nullable MGLAnnotationImage *)mapView:(MGLMapView *)mapView imageForAnnotation:(id <MGLAnnotation>)annotation;
506 | 
507 | /** Returns the alpha value to use when rendering a shape annotation. Defaults to `1.0`.
508 | *   @param mapView The map view rendering the shape annotation.
509 | *   @param annotation The annotation being rendered.
510 | *   @return An alpha value between `0` and `1.0`. */
511 | - (CGFloat)mapView:(MGLMapView *)mapView alphaForShapeAnnotation:(MGLShape *)annotation;
512 | 
513 | /** Returns the stroke color to use when rendering a shape annotation. Defaults to black.
514 | *   @param mapView The map view rendering the shape annotation.
515 | *   @param annotation The annotation being rendered.
516 | *   @return A color to use for the shape outline. */
517 | - (UIColor *)mapView:(MGLMapView *)mapView strokeColorForShapeAnnotation:(MGLShape *)annotation;
518 | 
519 | /** Returns the fill color to use when rendering a polygon annotation. Defaults to blue.
520 | *   @param mapView The map view rendering the polygon annotation.
521 | *   @param annotation The annotation being rendered.
522 | *   @return A color to use for the polygon interior. */
523 | - (UIColor *)mapView:(MGLMapView *)mapView fillColorForPolygonAnnotation:(MGLPolygon *)annotation;
524 | 
525 | /** Returns the line width to use when rendering a polyline annotation. Defaults to `3.0`.
526 | *   @param mapView The map view rendering the polygon annotation.
527 | *   @param annotation The annotation being rendered.
528 | *   @return A line width for the polyline. */
529 | - (CGFloat)mapView:(MGLMapView *)mapView lineWidthForPolylineAnnotation:(MGLPolyline *)annotation;
530 | 
531 | /** Returns a Boolean value indicating whether the annotation is able to display extra information in a callout bubble.
532 | *
533 | *   If the value returned is `YES`, a standard callout bubble is shown when the user taps a selected annotation. The callout uses the title and subtitle text from the associated annotation object. If there is no title text, though, the annotation will not show a callout. The callout also displays any custom callout views returned by the delegate for the left and right callout accessory views.
534 | *
535 | *   If the value returned is `NO`, the value of the title and subtitle strings are ignored.
536 | *
537 | *   @param mapView The map view that requested the annotation callout ability.
538 | *   @param annotation The object representing the annotation.
539 | *   @return A Boolean indicating whether the annotation should show a callout. */
540 | - (BOOL)mapView:(MGLMapView *)mapView annotationCanShowCallout:(id <MGLAnnotation>)annotation;
541 | 
542 | /** Return the view to display on the left side of the standard callout bubble.
543 | *
544 | *   The default value is treated as if `nil`. The left callout view is typically used to display information about the annotation or to link to custom information provided by your application.
545 | *
546 | *   If the view you specify is also a descendant of the `UIControl` class, you can use the map view’s delegate to receive notifications when your control is tapped. If it does not descend from `UIControl`, your view is responsible for handling any touch events within its bounds.
547 | *
548 | *   @param mapView The map view presenting the annotation callout.
549 | *   @param annotation The object representing the annotation with the callout.
550 | *   @return The accessory view to display. */
551 | - (nullable UIView *)mapView:(MGLMapView *)mapView leftCalloutAccessoryViewForAnnotation:(id <MGLAnnotation>)annotation;
552 | 
553 | /** Return the view to display on the right side of the standard callout bubble.
554 | *
555 | *   The default value is treated is if `nil`. The right callout view is typically used to link to more detailed information about the annotation. A common view to specify for this property is `UIButton` object whose type is set to `UIButtonTypeDetailDisclosure`.
556 | *
557 | *   If the view you specify is also a descendant of the `UIControl` class, you can use the map view’s delegate to receive notifications when your control is tapped. If it does not descend from `UIControl`, your view is responsible for handling any touch events within its bounds.
558 | *
559 | *   @param mapView The map view presenting the annotation callout.
560 | *   @param annotation The object representing the annotation with the callout.
561 | *   @return The accessory view to display. */
562 | - (nullable UIView *)mapView:(MGLMapView *)mapView rightCalloutAccessoryViewForAnnotation:(id <MGLAnnotation>)annotation;
563 | 
564 | #pragma mark - Managing Annotations
565 | 
566 | /** @name Managing Annotations */
567 | 
568 | /** Tells the delegate that the user tapped one of the annotation's accessory buttons.
569 | *
570 | *  Accessory views contain custom content and are positioned on either side of the annotation title text. If a view you specify is a descendant of the `UIControl` class, the map view calls this method as a convenience whenever the user taps your view. You can use this method to respond to taps and perform any actions associated with that control. For example, if your control displayed additional information about the annotation, you could use this method to present a modal panel with that information.
571 | *
572 | *  If your custom accessory views are not descendants of the `UIControl` class, the map view does not call this method.
573 | *
574 | *  @param mapView The map view containing the specified annotation.
575 | *  @param annotation The annotation whose button was tapped.
576 | *  @param control The control that was tapped. */
577 | - (void)mapView:(MGLMapView *)mapView annotation:(id <MGLAnnotation>)annotation calloutAccessoryControlTapped:(UIControl *)control;
578 | 
579 | /** Tells the delegate that the user tapped on an annotation's callout view.
580 | *   @param mapView The map view containing the specified annotation.
581 | *   @param annotation The annotation whose callout was tapped.*/
582 | - (void)mapView:(MGLMapView *)mapView tapOnCalloutForAnnotation:(id <MGLAnnotation>)annotation;
583 | 
584 | #pragma mark - Selecting Annotations
585 | 
586 | /** @name Selecting Annotations */
587 | 
588 | /** Tells the delegate that one of its annotations was selected.
589 | *
590 | *  You can use this method to track changes in the selection state of annotations.
591 | *
592 | *  @param mapView The map view containing the annotation.
593 | *  @param annotation The annotation that was selected. */
594 | - (void)mapView:(MGLMapView *)mapView didSelectAnnotation:(id <MGLAnnotation>)annotation;
595 | 
596 | /** Tells the delegate that one of its annotations was deselected.
597 | *
598 | *  You can use this method to track changes in the selection state of annotations.
599 | *
600 | *  @param mapView The map view containing the annotation.
601 | *  @param annotation The annotation that was deselected. */
602 | - (void)mapView:(MGLMapView *)mapView didDeselectAnnotation:(id <MGLAnnotation>)annotation;
603 | 
604 | @end
605 | 
606 | NS_ASSUME_NONNULL_END
607 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLMultiPoint.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | #import <CoreLocation/CoreLocation.h>
 3 | 
 4 | #import "MGLShape.h"
 5 | 
 6 | #import "MGLTypes.h"
 7 | 
 8 | NS_ASSUME_NONNULL_BEGIN
 9 | 
10 | /** The `MGLMultiPoint` class is an abstract superclass used to define shapes composed of multiple points. You should not create instances of this class directly. Instead, you should create instances of the `MGLPolyline` or `MGLPolygon` classes. However, you can use the method and properties of this class to access information about the specific points associated with the line or polygon. */
11 | @interface MGLMultiPoint : MGLShape
12 | 
13 | /** The number of points associated with the shape. (read-only) */
14 | @property (nonatomic, readonly) NSUInteger pointCount;
15 | 
16 | /** Retrieves one or more coordinates associated with the shape.
17 | *   @param coords On input, you must provide a C array of structures large enough to hold the desired number of coordinates. On output, this structure contains the requested coordinate data.
18 | *   @param range The range of points you want. The `location` field indicates the first point you are requesting, with `0` being the first point, `1` being the second point, and so on. The `length` field indicates the number of points you want. The array in _`coords`_ must be large enough to accommodate the number of requested coordinates. */
19 | - (void)getCoordinates:(CLLocationCoordinate2D *)coords range:(NSRange)range;
20 | 
21 | @end
22 | 
23 | NS_ASSUME_NONNULL_END
24 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLOverlay.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | #import <CoreLocation/CoreLocation.h>
 3 | 
 4 | #import "MGLAnnotation.h"
 5 | #import "MGLGeometry.h"
 6 | 
 7 | #import "MGLTypes.h"
 8 | 
 9 | NS_ASSUME_NONNULL_BEGIN
10 | 
11 | /** The `MGLOverlay` protocol defines a specific type of annotation that represents both a point and an area on a map. Overlay objects are essentially data objects that contain the geographic data needed to represent the map area. For example, overlays can take the form of common shapes such as rectangles and circles. They can also describe polygons and other complex shapes.
12 | *
13 | *   You use overlays to layer more sophisticated content on top of a map view. For example, you could use an overlay to show the boundaries of a national park or trace a bus route along city streets. The Mapbox iOS SDK defines several concrete classes that conform to this protocol and define standard shapes.
14 | *
15 | *   Because overlays are also annotations, they have similar usage pattern to annotations. When added to a map view using the `addOverlay:` method, that view detects whenever the overlay’s defined region intersects the visible portion of the map. At that point, the map view asks its delegate to provide a special overlay view to draw the visual representation of the overlay. If you add an overlay to a map view as an annotation instead, it is treated as an annotation with a single point. */
16 | @protocol MGLOverlay <MGLAnnotation>
17 | 
18 | /* The approximate center point of the overlay area. (required) (read-only)
19 | *
20 | *  This point is typically set to the center point of the map’s bounding rectangle. It is used as the anchor point for any callouts displayed for the annotation. */
21 | @property (nonatomic, readonly) CLLocationCoordinate2D coordinate;
22 | 
23 | /** The cooordinate rectangle that encompasses the overlay. (required) (read-only)
24 | *
25 | *   This property contains the smallest rectangle that completely encompasses the overlay. Implementers of this protocol must set this area when implementing their overlay class, and after setting it, you must not change it. */
26 | @property (nonatomic, readonly) MGLCoordinateBounds overlayBounds;
27 | 
28 | /** Returns a Boolean indicating whether the specified rectangle intersects the receiver’s shape.
29 | *
30 | *   You can implement this method to provide more specific bounds checking for an overlay. If you do not implement it, the bounding rectangle is used to detect intersections.
31 | *   @param overlayBounds The rectangle to intersect with the receiver’s area.
32 | *   @return `YES` if any part of the map rectangle intersects the receiver’s shape or `NO` if it does not. */
33 | - (BOOL)intersectsOverlayBounds:(MGLCoordinateBounds)overlayBounds;
34 | 
35 | @end
36 | 
37 | NS_ASSUME_NONNULL_END
38 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLPointAnnotation.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | #import <CoreLocation/CoreLocation.h>
 3 | 
 4 | #import "MGLShape.h"
 5 | 
 6 | #import "MGLTypes.h"
 7 | 
 8 | NS_ASSUME_NONNULL_BEGIN
 9 | 
10 | /** The `MGLPointAnnotation` class defines a concrete annotation object located at a specified point. You can use this class, rather than define your own, in situations where all you want to do is associate a point on the map with a title. */
11 | @interface MGLPointAnnotation : MGLShape
12 | 
13 | /** The coordinate point of the annotation, specified as a latitude and longitude. */
14 | @property (nonatomic, assign) CLLocationCoordinate2D coordinate;
15 | 
16 | @end
17 | 
18 | NS_ASSUME_NONNULL_END
19 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLPolygon.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | #import <CoreLocation/CoreLocation.h>
 3 | 
 4 | #import "MGLMultiPoint.h"
 5 | #import "MGLOverlay.h"
 6 | 
 7 | #import "MGLTypes.h"
 8 | 
 9 | NS_ASSUME_NONNULL_BEGIN
10 | 
11 | /** The `MGLPolygon` class represents a shape consisting of one or more points that define a closed polygon. The points are connected end-to-end in the order they are provided. The first and last points are connected to each other to create the closed shape. */
12 | @interface MGLPolygon : MGLMultiPoint <MGLOverlay>
13 | 
14 | /** Creates and returns an `MGLPolygon` object from the specified set of coordinates.
15 | *   @param coords The array of coordinates defining the shape. The data in this array is copied to the new object.
16 | *   @param count The number of items in the _`coords`_ array.
17 | *   @return A new polygon object. */
18 | + (instancetype)polygonWithCoordinates:(CLLocationCoordinate2D *)coords
19 |                                  count:(NSUInteger)count;
20 | 
21 | @end
22 | 
23 | NS_ASSUME_NONNULL_END
24 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLPolyline.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | #import <CoreLocation/CoreLocation.h>
 3 | 
 4 | #import "MGLMultiPoint.h"
 5 | #import "MGLOverlay.h"
 6 | 
 7 | #import "MGLTypes.h"
 8 | 
 9 | NS_ASSUME_NONNULL_BEGIN
10 | 
11 | /** The `MGLPolyline` class represents a shape consisting of one or more points that define connecting line segments. The points are connected end-to-end in the order they are provided. The first and last points are not connected to each other. */
12 | @interface MGLPolyline : MGLMultiPoint <MGLOverlay>
13 | 
14 | /** Creates and returns an `MGLPolyline` object from the specified set of coordinates.
15 | *   @param coords The array of coordinates defining the shape. The data in this array is copied to the new object.
16 | *   @param count The number of items in the _`coords`_ array.
17 | *   @return A new polyline object. */
18 | + (instancetype)polylineWithCoordinates:(CLLocationCoordinate2D *)coords
19 |                                   count:(NSUInteger)count;
20 | 
21 | @end
22 | 
23 | NS_ASSUME_NONNULL_END
24 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLShape.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | 
 3 | #import "MGLAnnotation.h"
 4 | 
 5 | #import "MGLTypes.h"
 6 | 
 7 | NS_ASSUME_NONNULL_BEGIN
 8 | 
 9 | /** The `MGLShape` class is an abstract class that defines the basic properties for all shape-based annotation objects. This class must be subclassed and cannot be used as is. Subclasses are responsible for defining the geometry of the shape and providing an appropriate value for the coordinate property inherited from the `MGLAnnotation` protocol. */
10 | @interface MGLShape : NSObject <MGLAnnotation>
11 | 
12 | /** The title of the shape annotation. The default value of this property is `nil`. */
13 | @property (nonatomic, copy, nullable) NSString *title;
14 | 
15 | /** The subtitle of the shape annotation. The default value of this property is `nil`. */
16 | @property (nonatomic, copy, nullable) NSString *subtitle;
17 | 
18 | @end
19 | 
20 | NS_ASSUME_NONNULL_END
21 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLStyle.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | 
 3 | #import "MGLTypes.h"
 4 | 
 5 | NS_ASSUME_NONNULL_BEGIN
 6 | 
 7 | /** A collection of convenience methods for creating style URLs of default styles provided by Mapbox. These instances of NSURL are cached. */
 8 | @interface MGLStyle : NSObject
 9 | 
10 | /** Returns the Streets style URL.
11 | *   Mapbox Streets is a complete base map, perfect for incorporating your own data. */
12 | + (NSURL *)streetsStyleURL;
13 | 
14 | /** Returns the Emerald style URL.
15 | *   Emerald is a versatile style with emphasis on road networks and public transportation. */
16 | + (NSURL *)emeraldStyleURL;
17 | 
18 | /** Returns the Light style URL.
19 | *   Light is a subtle, light-colored backdrop for data visualizations. */
20 | + (NSURL *)lightStyleURL;
21 | 
22 | /** Returns the Dark style URL.
23 | *   Dark is a subtle, dark-colored backdrop for data visualizations. */
24 | + (NSURL *)darkStyleURL;
25 | 
26 | /** Returns the Satellite style URL.
27 | *   Mapbox Satellite is a beautiful global satellite and aerial imagery layer. */
28 | + (NSURL *)satelliteStyleURL;
29 | 
30 | /** Returns the Hybrid style URL.
31 | *   Hybrid combines the global satellite and aerial imagery of Mapbox Satellite with unobtrusive labels. */
32 | + (NSURL *)hybridStyleURL;
33 | 
34 | - (instancetype)init NS_UNAVAILABLE;
35 | 
36 | @end
37 | 
38 | NS_ASSUME_NONNULL_END
39 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLTypes.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | 
 3 | #pragma once
 4 | 
 5 | #if !__has_feature(nullability)
 6 |     #define NS_ASSUME_NONNULL_BEGIN
 7 |     #define NS_ASSUME_NONNULL_END
 8 |     #define nullable
 9 |     #define nonnull
10 |     #define null_resettable
11 | #endif
12 | 
13 | NS_ASSUME_NONNULL_BEGIN
14 | 
15 | extern NSString * const MGLErrorDomain;
16 | 
17 | /** The mode used to track the user location on the map. */
18 | typedef NS_ENUM(NSUInteger, MGLUserTrackingMode) {
19 |     /** The map does not follow the user location. */
20 |     MGLUserTrackingModeNone              = 0,
21 |     /** The map follows the user location. */
22 |     MGLUserTrackingModeFollow,
23 |     /** The map follows the user location and rotates when the heading changes. */
24 |     MGLUserTrackingModeFollowWithHeading,
25 |     /** The map follows the user location and rotates when the course changes. */
26 |     MGLUserTrackingModeFollowWithCourse,
27 | };
28 | 
29 | NS_ASSUME_NONNULL_END
30 | 
31 | #pragma clang diagnostic push
32 | #pragma clang diagnostic ignored "-Wvariadic-macros"
33 |     #if __has_feature(objc_generics)
34 |         /** Inserts a type specifier for a pointer to a lightweight generic with the given collection and object classes. Use a `*` for any non-`id` object classes but no `*` for the collection class. */
35 |         #define NS_ARRAY_OF(ObjectClass...)                 NSArray <ObjectClass>
36 |         #define NS_MUTABLE_ARRAY_OF(ObjectClass...)         NSMutableArray <ObjectClass>
37 |         #define NS_SET_OF(ObjectClass...)                   NSSet <ObjectClass>
38 |         #define NS_MUTABLE_SET_OF(ObjectClass...)           NSMutableSet <ObjectClass>
39 |         #define NS_DICTIONARY_OF(ObjectClass...)            NSDictionary <ObjectClass>
40 |         #define NS_MUTABLE_DICTIONARY_OF(ObjectClass...)    NSMutableDictionary <ObjectClass>
41 |     #else
42 |         #define NS_ARRAY_OF(ObjectClass...)                 NSArray
43 |         #define NS_MUTABLE_ARRAY_OF(ObjectClass...)         NSMutableArray
44 |         #define NS_SET_OF(ObjectClass...)                   NSSet
45 |         #define NS_MUTABLE_SET_OF(ObjectClass...)           NSMutableSet
46 |         #define NS_DICTIONARY_OF(ObjectClass...)            NSDictionary
47 |         #define NS_MUTABLE_DICTIONARY_OF(ObjectClass...)    NSMutableDictionary
48 |     #endif
49 | #pragma clang diagnostic pop
50 | 


--------------------------------------------------------------------------------
/src/ios/Headers/MGLUserLocation.h:
--------------------------------------------------------------------------------
 1 | #import <Foundation/Foundation.h>
 2 | #import <CoreLocation/CoreLocation.h>
 3 | 
 4 | #import "MGLAnnotation.h"
 5 | 
 6 | #import "MGLTypes.h"
 7 | 
 8 | NS_ASSUME_NONNULL_BEGIN
 9 | 
10 | /** The MGLUserLocation class defines a specific type of annotation that identifies the user’s current location. You do not create instances of this class directly. Instead, you retrieve an existing MGLUserLocation object from the userLocation property of the map view displayed in your application. */
11 | @interface MGLUserLocation : NSObject <MGLAnnotation>
12 | 
13 | /** @name Determining the User’s Position */
14 | 
15 | /** The current location of the device. (read-only)
16 | *
17 | *   This property contains `nil` if the map view is not currently showing the user location or if the user’s location has not yet been determined. */
18 | @property (nonatomic, readonly, nullable) CLLocation *location;
19 | 
20 | /** A Boolean value indicating whether the user’s location is currently being updated. (read-only) */
21 | @property (nonatomic, readonly, getter=isUpdating) BOOL updating;
22 | 
23 | /** The heading of the user location. (read-only)
24 | *
25 | * This property is `nil` if the user location tracking mode is not `MGLUserTrackingModeFollowWithHeading`. */
26 | @property (nonatomic, readonly, nullable) CLHeading *heading;
27 | 
28 | /** @name Accessing the User Annotation Text */
29 | 
30 | /** The title to display for the user location annotation. */
31 | @property (nonatomic, copy) NSString *title;
32 | 
33 | /** The subtitle to display for the user location annotation. */
34 | @property (nonatomic, copy, nullable) NSString *subtitle;
35 | 
36 | @end
37 | 
38 | NS_ASSUME_NONNULL_END
39 | 


--------------------------------------------------------------------------------
/src/ios/Headers/Mapbox.h:
--------------------------------------------------------------------------------
 1 | #import "MGLAccountManager.h"
 2 | #import "MGLAnnotation.h"
 3 | #import "MGLAnnotationImage.h"
 4 | #import "MGLMapCamera.h"
 5 | #import "MGLGeometry.h"
 6 | #import "MGLMapView.h"
 7 | #import "MGLMapView+IBAdditions.h"
 8 | #import "MGLMultiPoint.h"
 9 | #import "MGLOverlay.h"
10 | #import "MGLPointAnnotation.h"
11 | #import "MGLPolygon.h"
12 | #import "MGLPolyline.h"
13 | #import "MGLShape.h"
14 | #import "MGLStyle.h"
15 | #import "MGLTypes.h"
16 | #import "MGLUserLocation.h"
17 | 


--------------------------------------------------------------------------------
/src/ios/libs/Mapbox.bundle/Compass.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/Mapbox.bundle/Compass.png


--------------------------------------------------------------------------------
/src/ios/libs/Mapbox.bundle/Compass@2x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/Mapbox.bundle/Compass@2x.png


--------------------------------------------------------------------------------
/src/ios/libs/Mapbox.bundle/Compass@3x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/Mapbox.bundle/Compass@3x.png


--------------------------------------------------------------------------------
/src/ios/libs/Mapbox.bundle/README:
--------------------------------------------------------------------------------
1 | When adding new image resources, make sure that you've reduced the file size as much as possible using a tool such as:
2 | 
3 | ImageOptim — https://imageoptim.com
4 | 
5 | See also: https://github.com/mapbox/mapbox-gl-native/pull/2227


--------------------------------------------------------------------------------
/src/ios/libs/Mapbox.bundle/api_mapbox_com-digicert.der:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/Mapbox.bundle/api_mapbox_com-digicert.der


--------------------------------------------------------------------------------
/src/ios/libs/Mapbox.bundle/api_mapbox_com-geotrust.der:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/Mapbox.bundle/api_mapbox_com-geotrust.der


--------------------------------------------------------------------------------
/src/ios/libs/Mapbox.bundle/default_marker.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/Mapbox.bundle/default_marker.png


--------------------------------------------------------------------------------
/src/ios/libs/Mapbox.bundle/default_marker@2x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/Mapbox.bundle/default_marker@2x.png


--------------------------------------------------------------------------------
/src/ios/libs/Mapbox.bundle/default_marker@3x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/Mapbox.bundle/default_marker@3x.png


--------------------------------------------------------------------------------
/src/ios/libs/Mapbox.bundle/mapbox.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/Mapbox.bundle/mapbox.png


--------------------------------------------------------------------------------
/src/ios/libs/Mapbox.bundle/mapbox@2x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/Mapbox.bundle/mapbox@2x.png


--------------------------------------------------------------------------------
/src/ios/libs/Mapbox.bundle/mapbox@3x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/Mapbox.bundle/mapbox@3x.png


--------------------------------------------------------------------------------
/src/ios/libs/Mapbox.bundle/star_tilestream_net.der:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/Mapbox.bundle/star_tilestream_net.der


--------------------------------------------------------------------------------
/src/ios/libs/Settings.bundle/Root.plist:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 3 | <plist version="1.0">
 4 | <dict>
 5 | 	<key>PreferenceSpecifiers</key>
 6 | 	<array>
 7 | 		<dict>
 8 | 			<key>Title</key>
 9 | 			<string>Privacy Settings</string>
10 | 			<key>Type</key>
11 | 			<string>PSGroupSpecifier</string>
12 | 			<key>FooterText</key>
13 | 			<string>This setting allows the application to share anonymized location and usage data with Mapbox.</string>
14 | 		</dict>
15 | 		<dict>
16 | 			<key>DefaultValue</key>
17 | 			<true/>
18 | 			<key>Key</key>
19 | 			<string>MGLMapboxMetricsEnabled</string>
20 | 			<key>Title</key>
21 | 			<string>Mapbox Metrics</string>
22 | 			<key>Type</key>
23 | 			<string>PSToggleSwitchSpecifier</string>
24 | 			<key>TrueValue</key>
25 | 			<true/>
26 | 			<key>FalseValue</key>
27 | 			<false/>
28 | 		</dict>
29 | 	</array>
30 | 	<key>StringsTable</key>
31 | 	<string>Root</string>
32 | </dict>
33 | </plist>
34 | 


--------------------------------------------------------------------------------
/src/ios/libs/Settings.bundle/en.lproj/Root.strings:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/Settings.bundle/en.lproj/Root.strings


--------------------------------------------------------------------------------
/src/ios/libs/libMapbox.a:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Telerik-Verified-Plugins/Mapbox/717930e83e915bb1cb442beb53b23a66cf7388d6/src/ios/libs/libMapbox.a


--------------------------------------------------------------------------------
/src/ios/libs/version.txt:
--------------------------------------------------------------------------------
1 | https://github.com/mapbox/mapbox-gl-native/releases/tag/ios-v3.0.1


--------------------------------------------------------------------------------
/typescript/mapbox.d.ts:
--------------------------------------------------------------------------------
 1 | /// <reference path="../../libs/typings/tsd.d.ts" />
 2 | declare var Mapbox: mapbox.IMap;
 3 | 
 4 | declare module mapbox {
 5 |     export interface IMarkerOptions {
 6 |         lat: number,
 7 |         lng: number,
 8 |         /**no popup unless set*/
 9 |         title?: string,
10 |         subtitle?: string,
11 |         image?: string | {
12 |             url?: string,
13 |             data?: string,
14 |             svg?: string,
15 |             height?: number,
16 |             width?: number
17 |         }
18 |     }
19 | 
20 |     export interface IGeoPoint {
21 |         lat: number,
22 |         lng: number
23 |     }
24 | 
25 |     export interface ITilt {
26 |         pitch: number,
27 |         duration: number
28 |     }
29 | 
30 |     export interface IMap {
31 |         show: (options: {
32 |             /** light|dark|emerald|satellite|streets , default 'streets'*/
33 |             style: string,
34 |             /***/
35 |             margins?: {
36 |                 left?: number, // default 0
37 |                 right?: number, // default 0
38 |                 top?: number, // default 0
39 |                 bottom?: number // default 0
40 |             },
41 |             center?: { // optional, without a default
42 |                 lat: number,
43 |                 lng: number
44 |             },
45 |             /**0 (the entire world) to 20, default 10*/
46 |             zoomLevel?: number,
47 |             /**your app will ask permission to the user, default false*/
48 |             showUserLocation?: boolean,
49 |             /**default false, Mapbox requires this default if you're on a free plan*/
50 |             hideAttribution: boolean,
51 |             /** default false, Mapbox requires this default if you're on a free plan*/
52 |             hideLogo: boolean,
53 |             hideCompass?: boolean, // default false
54 |             disableRotation?: boolean, // default false
55 |             disableScroll?: boolean, // default false
56 |             disableZoom?: boolean, // default false
57 |             /** disable the two-finger perspective gesture, default false*/
58 |             disablePitch?: boolean,
59 |             markers?: IMarkerOptions[]
60 |         }, successCallback?: (msg: string) => void,
61 |             errorCallback?: (msg: string) => void) => void,
62 |         hide: (options?: any,
63 |             successCallback?: (msg: string) => void,
64 |             errorCallback?: (msg: string) => void) => void,
65 |         addMarkerCallback: (callback: (selectedMarker: IMarkerOptions) => void) => void,
66 |         getCenter: (callback: (p: IGeoPoint) => void) => void,
67 |         setCenter: (p: IGeoPoint) => void,
68 |         getZoomLevel: (callback: (z: number) => void) => void,
69 |         getTilt: (callback: (z: ITilt) => void) => void,
70 |         setTilt: (p: ITilt) => void,
71 |     }
72 | }
73 | 


--------------------------------------------------------------------------------
/www/Mapbox.js:
--------------------------------------------------------------------------------
 1 | var exec = require("cordova/exec");
 2 | 
 3 | module.exports = {
 4 |   show: function (options, successCallback, errorCallback) {
 5 |     cordova.exec(successCallback, errorCallback, "Mapbox", "show", [options]);
 6 |   },
 7 | 
 8 |   hide: function (options, successCallback, errorCallback) {
 9 |     cordova.exec(successCallback, errorCallback, "Mapbox", "hide", [options]);
10 |   },
11 | 
12 |   addMarkers: function (options, successCallback, errorCallback) {
13 |     cordova.exec(successCallback, errorCallback, "Mapbox", "addMarkers", [options]);
14 |   },
15 | 
16 |   removeAllMarkers: function (successCallback, errorCallback) {
17 |     cordova.exec(successCallback, errorCallback, "Mapbox", "removeAllMarkers", []);
18 |   },
19 | 
20 |   addMarkerCallback: function (callback) {
21 |     cordova.exec(callback, null, "Mapbox", "addMarkerCallback", []);
22 |   },
23 | 
24 |   animateCamera: function (options, successCallback, errorCallback) {
25 |     cordova.exec(successCallback, errorCallback, "Mapbox", "animateCamera", [options]);
26 |   },
27 | 
28 |   addGeoJSON: function (options, successCallback, errorCallback) {
29 |     cordova.exec(successCallback, errorCallback, "Mapbox", "addGeoJSON", [options]);
30 |   },
31 | 
32 |   setCenter: function (options, successCallback, errorCallback) {
33 |     cordova.exec(successCallback, errorCallback, "Mapbox", "setCenter", [options]);
34 |   },
35 | 
36 |   getCenter: function (successCallback, errorCallback) {
37 |     cordova.exec(successCallback, errorCallback, "Mapbox", "getCenter", []);
38 |   },
39 | 
40 |   setTilt: function (options, successCallback, errorCallback) {
41 |     cordova.exec(successCallback, errorCallback, "Mapbox", "setTilt", [options]);
42 |   },
43 | 
44 |   getTilt: function (successCallback, errorCallback) {
45 |     cordova.exec(successCallback, errorCallback, "Mapbox", "getTilt", []);
46 |   },
47 | 
48 |   getZoomLevel: function (successCallback, errorCallback) {
49 |     cordova.exec(successCallback, errorCallback, "Mapbox", "getZoomLevel", []);
50 |   },
51 | 
52 |   setZoomLevel: function (options, successCallback, errorCallback) {
53 |     cordova.exec(successCallback, errorCallback, "Mapbox", "setZoomLevel", [options]);
54 |   },
55 | 
56 |   getBounds: function (successCallback, errorCallback) {
57 |     cordova.exec(successCallback, errorCallback, "Mapbox", "getBounds", []);
58 |   },
59 | 
60 |   setBounds: function (options, successCallback, errorCallback) {
61 |     cordova.exec(successCallback, errorCallback, "Mapbox", "setBounds", [options]);
62 |   },
63 | 
64 |   addPolygon: function (options, successCallback, errorCallback) {
65 |     cordova.exec(successCallback, errorCallback, "Mapbox", "addPolygon", [options]);
66 |   },
67 | 
68 |   convertCoordinate: function(options, successCallback, errorCallback){
69 |     cordova.exec(successCallback, errorCallback, "Mapbox", "convertCoordinate", [options]);
70 |   },
71 | 
72 |   convertPoint: function(options, successCallback, errorCallback){
73 |     cordova.exec(successCallback, errorCallback, "Mapbox", "convertPoint", [options]);
74 |   },
75 | 
76 |   onRegionWillChange: function(callback){
77 |     cordova.exec(callback, null, "Mapbox", "onRegionWillChange", []);
78 |   },
79 | 
80 |   onRegionIsChanging: function(callback){
81 |     cordova.exec(callback, null, "Mapbox", "onRegionIsChanging", []);
82 |   },
83 | 
84 |   onRegionDidChange: function(callback){
85 |     cordova.exec(callback, null, "Mapbox", "onRegionDidChange", []);
86 |   }
87 | };
88 | 


--------------------------------------------------------------------------------