Initial revision

1 files changed, 232 insertions, 0 deletions

diff --git a/iphone/FixMyStreet/MyCLController.m b/iphone/FixMyStreet/MyCLController.m
new file mode 100755
index 000000000..d289d6ade
--- /dev/null
+++ b/iphone/FixMyStreet/MyCLController.m
@@ -0,0 +1,232 @@
+/*
+
+File: MyCLController.m
+Abstract: Singleton class used to talk to CoreLocation and send results back to
+the app's view controllers.
+
+Version: 1.1
+
+Disclaimer: IMPORTANT:  This Apple software is supplied to you by Apple Inc.
+("Apple") in consideration of your agreement to the following terms, and your
+use, installation, modification or redistribution of this Apple software
+constitutes acceptance of these terms.  If you do not agree with these terms,
+please do not use, install, modify or redistribute this Apple software.
+
+In consideration of your agreement to abide by the following terms, and subject
+to these terms, Apple grants you a personal, non-exclusive license, under
+Apple's copyrights in this original Apple software (the "Apple Software"), to
+use, reproduce, modify and redistribute the Apple Software, with or without
+modifications, in source and/or binary forms; provided that if you redistribute
+the Apple Software in its entirety and without modifications, you must retain
+this notice and the following text and disclaimers in all such redistributions
+of the Apple Software.
+Neither the name, trademarks, service marks or logos of Apple Inc. may be used
+to endorse or promote products derived from the Apple Software without specific
+prior written permission from Apple.  Except as expressly stated in this notice,
+no other rights or licenses, express or implied, are granted by Apple herein,
+including but not limited to any patent rights that may be infringed by your
+derivative works or by other works in which the Apple Software may be
+incorporated.
+
+The Apple Software is provided by Apple on an "AS IS" basis.  APPLE MAKES NO
+WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED
+WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND OPERATION ALONE OR IN
+COMBINATION WITH YOUR PRODUCTS.
+
+IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, MODIFICATION AND/OR
+DISTRIBUTION OF THE APPLE SOFTWARE, HOWEVER CAUSED AND WHETHER UNDER THEORY OF
+CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF
+APPLE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Copyright (C) 2008 Apple Inc. All Rights Reserved.
+
+*/
+
+#import "MyCLController.h"
+
+// This is a singleton class, see below
+static MyCLController *sharedCLDelegate = nil;
+
+@implementation MyCLController
+
+@synthesize delegate, locationManager, updating;
+
+- (id) init {
+	self = [super init];
+	if (self != nil) {
+		self.locationManager = [[[CLLocationManager alloc] init] autorelease];
+		self.locationManager.delegate = self; // Tells the location manager to send updates to this object
+	}
+	return self;
+}
+
+-(void)startUpdatingLocation {
+	self.updating = YES;
+	[self.locationManager startUpdatingLocation];
+}
+
+
+// Called when the location is updated
+- (void)locationManager:(CLLocationManager *)manager
+	didUpdateToLocation:(CLLocation *)newLocation
+		   fromLocation:(CLLocation *)oldLocation
+{
+	NSMutableString *update = [[[NSMutableString alloc] init] autorelease];
+	
+	// Timestamp
+	NSDateFormatter *dateFormatter = [[[NSDateFormatter alloc] init]  autorelease];
+	[dateFormatter setDateStyle:NSDateFormatterMediumStyle];
+	[dateFormatter setTimeStyle:NSDateFormatterMediumStyle];
+	[update appendFormat:@"%@\n\n", [dateFormatter stringFromDate:newLocation.timestamp]];
+	
+	// Horizontal coordinates
+	if (signbit(newLocation.horizontalAccuracy)) {
+		// Negative accuracy means an invalid or unavailable measurement
+		[update appendString:@"Latitude / Longitude unavailable"];
+	} else {
+		// CoreLocation returns positive for North & East, negative for South & West
+		[update appendFormat:@"Location: %.4f° %@, %.4f° %@", // This format takes 4 args: 2 pairs of the form coordinate + compass direction
+			fabs(newLocation.coordinate.latitude), signbit(newLocation.coordinate.latitude) ? (@"South") : (@"North"),
+			fabs(newLocation.coordinate.longitude),	signbit(newLocation.coordinate.longitude) ? (@"West") : (@"East")];
+		[update appendString:@"\n"];
+		[update appendFormat:@"(accuracy %.0f metres)", newLocation.horizontalAccuracy];
+	}
+	[update appendString:@"\n\n"];
+
+	// Altitude
+	if (signbit(newLocation.verticalAccuracy)) {
+		// Negative accuracy means an invalid or unavailable measurement
+		[update appendString:@"Altitude Unavailable"];
+	} else {
+		// Positive and negative in altitude denote above & below sea level, respectively
+		[update appendFormat:@"Altitude: %.2f metres %@", fabs(newLocation.altitude),	(signbit(newLocation.altitude)) ? @"below sea level" : @"above sea level"];
+		[update appendString:@"\n"];
+		[update appendFormat:@"(accuracy %.0f metres)", newLocation.verticalAccuracy];
+	}
+	[update appendString:@"\n\n"];
+	
+	// Calculate disatance moved and time elapsed, but only if we have an "old" location
+	//
+	// NOTE: Timestamps are based on when queries start, not when they return. CoreLocation will query your
+	// location based on several methods. Sometimes, queries can come back in a different order from which
+	// they were placed, which means the timestamp on the "old" location can sometimes be newer than on the
+	// "new" location. For the example, we will clamp the timeElapsed to zero to avoid showing negative times
+	// in the UI.
+	//
+	if (oldLocation != nil) {
+		CLLocationDistance distanceMoved = [newLocation getDistanceFrom:oldLocation];
+		NSTimeInterval timeElapsed = [newLocation.timestamp timeIntervalSinceDate:oldLocation.timestamp];
+		
+		[update appendFormat:@"Location changed %.2f metres ", distanceMoved];
+		if (signbit(timeElapsed)) {
+			[update appendString:@"since previous measurement"];
+		} else {
+			[update appendFormat:@"in %.1f seconds", timeElapsed];
+		}
+		[update appendString:@"\n\n"];
+	}
+	
+	// Send the update to our delegate
+	[self.delegate newLocationUpdate:update];
+}
+
+
+// Called when there is an error getting the location
+- (void)locationManager:(CLLocationManager *)manager
+	   didFailWithError:(NSError *)error
+{
+	NSMutableString *errorString = [[[NSMutableString alloc] init] autorelease];
+
+	if ([error domain] == kCLErrorDomain) {
+
+		// We handle CoreLocation-related errors here
+
+		switch ([error code]) {
+			// This error code is usually returned whenever user taps "Don't Allow" in response to
+			// being told your app wants to access the current location. Once this happens, you cannot
+			// attempt to get the location again until the app has quit and relaunched.
+			//
+			// "Don't Allow" on two successive app launches is the same as saying "never allow". The user
+			// can reset this for all apps by going to Settings > General > Reset > Reset Location Warnings.
+			//
+			case kCLErrorDenied:
+				[errorString appendFormat:@"%@\n", NSLocalizedString(@"LocationDenied", nil)];
+				break;
+
+			// This error code is usually returned whenever the device has no data or WiFi connectivity,
+			// or when the location cannot be determined for some other reason.
+			//
+			// CoreLocation will keep trying, so you can keep waiting, or prompt the user.
+			//
+			case kCLErrorLocationUnknown:
+				[errorString appendFormat:@"%@\n", NSLocalizedString(@"LocationUnknown", nil)];
+				break;
+
+			// We shouldn't ever get an unknown error code, but just in case...
+			//
+			default:
+				[errorString appendFormat:@"%@ %d\n", NSLocalizedString(@"GenericLocationError", nil), [error code]];
+				break;
+		}
+	} else {
+		// We handle all non-CoreLocation errors here
+		// (we depend on localizedDescription for localization)
+		[errorString appendFormat:@"Error domain: \"%@\"  Error code: %d\n", [error domain], [error code]];
+		[errorString appendFormat:@"Description: \"%@\"\n", [error localizedDescription]];
+	}
+
+	self.updating = NO;
+	
+	// Send the update to our delegate
+	[self.delegate newLocationUpdate:errorString];
+}
+
+#pragma mark ---- singleton object methods ----
+
+// See "Creating a Singleton Instance" in the Cocoa Fundamentals Guide for more info
+
++ (MyCLController *)sharedInstance {
+    @synchronized(self) {
+        if (sharedCLDelegate == nil) {
+            [[self alloc] init]; // assignment not done here
+        }
+    }
+    return sharedCLDelegate;
+}
+
++ (id)allocWithZone:(NSZone *)zone {
+    @synchronized(self) {
+        if (sharedCLDelegate == nil) {
+            sharedCLDelegate = [super allocWithZone:zone];
+            return sharedCLDelegate;  // assignment and return on first allocation
+        }
+    }
+    return nil; // on subsequent allocation attempts return nil
+}
+
+- (id)copyWithZone:(NSZone *)zone
+{
+    return self;
+}
+
+- (id)retain {
+    return self;
+}
+
+- (unsigned)retainCount {
+    return UINT_MAX;  // denotes an object that cannot be released
+}
+
+- (void)release {
+    //do nothing
+}
+
+- (id)autorelease {
+    return self;
+}
+
+@end
\ No newline at end of file