Merge pull request #139 from Automatic/objc-batch

Expose the batch geocoding function to Objective-C

Author: 1ec5

MapboxGeocoder/MBGeocoder.swift

@@ -207,7 +207,8 @@ open class Geocoder: NSObject {
      - returns: The data task used to perform the HTTP request. If, while waiting for the completion handler to execute, you no longer want the resulting placemarks, cancel this task.
      */
     @discardableResult
-    open func batchGeocode<T: GeocodeOptions>(_ options: T, completionHandler: @escaping BatchCompletionHandler) -> URLSessionDataTask where T: BatchGeocodeOptions {
+    @objc(batchGeocodeWithOptions:completionHandler:)
+    open func batchGeocode(_ options: GeocodeOptions & BatchGeocodeOptions, completionHandler: @escaping BatchCompletionHandler) -> URLSessionDataTask {
         let url = urlForGeocoding(options)
 
         let task = dataTaskWithURL(url, completionHandler: { (data) in

README.md

@@ -224,6 +224,30 @@ let task = geocoder.batchGeocode(options) { (placemarksByQuery, attributionsByQu
 }
 ```
 
+```objc
+// main.m
+MBForwardBatchGeocodeOptions *options = [[MBForwardBatchGeocodeOptions alloc] initWithQueries:@[@"skyline chili", @"gold star chili"]];
+options.focalLocation = locationManager.location;
+options.allowedScopes = MBPlacemarkScopePointOfInterest;
+
+NSURLSessionDataTask *task = [geocoder batchGeocodeWithOptions:options
+                                             completionHandler:^(NSArray<NSArray<MBGeocodedPlacemark *> *> * _Nullable placemarksByQuery,
+                                                                 NSArray<NSString *> * _Nullable attributionsByQuery,
+                                                                 NSError * _Nullable error) {
+    if (!placemarksByQuery) {
+        return;
+    }
+    
+    MBPlacemark *nearestSkyline = placemarksByQuery[0][0].location;
+    CLLocationDistance distanceToSkyline = [nearestSkyline distanceFromLocation:locationManager.location];
+    MBPlacemark *nearestGoldStar = placemarksByQuery[1][0].location;
+    CLLocationDistance distanceToGoldStar = [nearestGoldStar distanceFromLocation:locationManager.location];
+
+    NSString *distance = [NSLengthFormatter stringFromMeters:MIN(distanceToSkyline, distanceToGoldStar)];
+    NSLog(@"Found a chili parlor %@ away.", distance);
+}];
+```
+
 Batch geocoding is available to Mapbox enterprise accounts. See the [Mapbox Geocoding](https://www.mapbox.com/geocoding/) website for more information.
 
 ## Tests