Added SpatialCloud map source

Jon Hjelle
Commit eb41b80e94a69bda4065546c0d8b023f46fc84d1 1 parent 3a6b4534
Showing 3 changed files with 216 additions and 0 deletions
MapView/Map/RMSpatialCloudMapSource.h
MapView/Map/RMSpatialCloudMapSource.m
MapView/MapView.xcodeproj/project.pbxproj
--- a/MapView/Map/RMSpatialCloudMapSource.h 0 → 100644
View file @eb41b80
+++ b/MapView/Map/RMSpatialCloudMapSource.h 0 → 100644
View file @eb41b80
+//
+//  RMSpatialCloudMapSource.h
+//
+// Copyright (c) 2011, SpatialCloud
+// All rights reserved.
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are met:
+//
+// * Redistributions of source code must retain the above copyright notice, this
+//   list of conditions and the following disclaimer.
+// * Redistributions in binary form must reproduce the above copyright notice,
+//   this list of conditions and the following disclaimer in the documentation
+//   and/or other materials provided with the distribution.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+// POSSIBILITY OF SUCH DAMAGE.
+
+#import "RMAbstractMercatorWebSource.h"
+
+/*!
+ \brief Subclass of RMAbstractMercatorWebSource for access to SpatialCloud.com MapSources.
+ 
+ Allows access to SpatialCloud.com MapSources. Direct access can be attained using a loginID
+ and password. Alternatively, a proxy server can be used in place of a loginID and password. 
+ If both a loginID/password pair and a server URL are provided, the server URL will be used.
+ 
+ SpatialCloud.com MapSources are available for purchase & resale for various US & world 
+ datasets; in addition, SpatialCloud allows you to host/serve/resell your own datasets. 
+ Please visit http://spatialcloud.com to setup your own account, subscribe to the 
+ MapSource(s), & create your own MapStream(s), as well as licensing terms and fees.
+ */
+
+@interface RMSpatialCloudMapSource : RMAbstractMercatorWebSource <RMAbstractMercatorWebSource> {
+	NSString *customServerURL;
+	NSString *loginID;
+	NSString *password;
+}
+
+// URL string of proxy server used to access SpatialCloud.com tiles
+//
+// If you don't have a proxy server, use the loginID/password combination below
+// See http://www.spatialcloud.com/index.cfm?event=home.support for server sample code
+// Examples:
+// http://127.0.0.1:8080/openbd/custom/server/CFML/index.cfm?
+// http://localhost:8080/openbd/SSCustomServer/server/JSP/index.jsp?
+// http://localhost/server/PHP/index.php?
+@property (nonatomic, retain) NSString *customServerURL;
+
+// LoginID and password used to access a MapStream
+//
+// See http://www.spatialcloud.com/index.cfm?event=home.support to signup
+// For the purposes of this demo, use 20101213051851055 for the loginID and
+// gRtXbm79CODFq for the password
+// If you don't want to release your loginID in your app's binary, consider
+// using a proxy server as mentioned above
+@property (nonatomic, retain) NSString *loginID;
+@property (nonatomic, retain) NSString *password;
+
+- (id)initWithLoginID:(NSString *)newLoginID password:(NSString *)newPassword;
+- (id)initWithCustomServerURL:(NSString *)newCustomServerURL;
+
+@end
--- a/MapView/Map/RMSpatialCloudMapSource.m 0 → 100644
View file @eb41b80
+++ b/MapView/Map/RMSpatialCloudMapSource.m 0 → 100644
View file @eb41b80
+//
+//  RMSpatialCloudMapSource.m
+//
+// Copyright (c) 2011, SpatialCloud
+// All rights reserved.
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are met:
+//
+// * Redistributions of source code must retain the above copyright notice, this
+//   list of conditions and the following disclaimer.
+// * Redistributions in binary form must reproduce the above copyright notice,
+//   this list of conditions and the following disclaimer in the documentation
+//   and/or other materials provided with the distribution.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+// POSSIBILITY OF SUCH DAMAGE.
+
+#import "RMSpatialCloudMapSource.h"
+#import <CommonCrypto/CommonDigest.h>
+
+
+@implementation RMSpatialCloudMapSource
+
+@synthesize customServerURL;
+@synthesize loginID;
+@synthesize password;
+
+- (id)init {
+	self = [super init];
+	if (self) {
+		[self setMaxZoom:18];
+		[self setMinZoom:1];
+	}
+	return self;
+}
+
+- (id)initWithLoginID:(NSString *)newLoginID password:(NSString *)newPassword {
+	self = [self init];
+	if (self) {
+		loginID = [newLoginID retain];
+		password = [newPassword retain];
+	}
+	return self;
+}
+
+- (id)initWithCustomServerURL:(NSString *)newCustomServerURL {
+	self = [self init];
+	if (self) {
+		customServerURL = [newCustomServerURL retain];
+	}
+	return self;
+}
+
+- (void)dealloc {
+	[customServerURL release];
+	[loginID release];
+	[password release];
+	[super dealloc];
+}
+
+- (NSString *)md5HexDigest:(NSString *)stringToHash {
+	const char *cStringToHash = [stringToHash UTF8String];
+	unsigned char hash[CC_MD5_DIGEST_LENGTH];
+	CC_MD5(cStringToHash, strlen(cStringToHash), hash);
+	
+	NSMutableString *hashString = [NSMutableString stringWithCapacity:CC_MD5_DIGEST_LENGTH * 2];
+    for(int i = 0; i < CC_MD5_DIGEST_LENGTH; i++) {
+        [hashString appendFormat:@"%02X", hash[i]];
+    }
+	return hashString;
+}
+
+- (NSString *)tileURL:(RMTile)tile {
+	NSAssert4(((tile.zoom >= self.minZoom) && (tile.zoom <= self.maxZoom)),
+			  @"%@ tried to retrieve tile with zoomLevel %d, outside source's defined range %f to %f", 
+			  self, tile.zoom, self.minZoom, self.maxZoom);
+	NSAssert(([self.loginID length] > 0) || ([self.customServerURL length] > 0),
+			 @"Login ID or Custom Server URL for Spatial Cloud must be non-empty");
+	NSAssert(([self.password length] > 0) || ([self.customServerURL length] > 0),
+			 @"Password or Custom Server URL for Spatial Cloud must be non-empty");
+	
+	// Flip the y-coordinate from the default route-me scheme to the Spatial Cloud tile scheme
+	uint32_t flippedYCoordinate = (1 << tile.zoom) - 1 - tile.y;
+	
+	NSString* fullURL = nil;
+	if ([self.customServerURL length] > 0) {
+		fullURL = [NSString stringWithFormat:@"%@%d/%d/%d.jpg",
+				   customServerURL, tile.zoom, tile.x, flippedYCoordinate];
+	} else {
+		NSString *serverURL = @"http://ss.spatialcloud.com/getsign.cfm";
+		NSString *fileKey = [NSString stringWithFormat:@"%d/%d/%d.jpg",
+							 tile.zoom, tile.x, flippedYCoordinate];
+		
+		NSString *authSign = [NSString stringWithFormat:@"%@%@%@",
+							  fileKey, self.loginID, self.password];
+		NSString *authSignHash = [self md5HexDigest:authSign];
+		
+		fullURL = [NSString stringWithFormat:@"%@/1.0.0/spatialcloud/%@?loginid=%@&authSign=%@&viewer=viewer",
+				   serverURL, fileKey, self.loginID, authSignHash];
+	}
+	
+	return fullURL;
+}
+
+- (NSString *)uniqueTilecacheKey {
+	return @"SpatialCloud";
+}
+
+- (NSString *)shortName {
+	return @"SpatialCloud.com";
+}
+
+- (NSString *)longDescription {
+	return @"SpatialCloud.com MapSources are available for purchase & resale for various US & world datasets; in addition, SpatialCloud allows you to host/serve/resell your own datasets. Learn more at SpatialCloud.com.";
+}
+
+- (NSString *)shortAttribution {
+	return @"Spatial Cloud Demo";
+}
+
+- (NSString *)longAttribution {
+	return @"SpatialCloud MapSource terms vary, but this SpatialCloud Demo is for Route-Me code demo purposes only.  The demo MapSource provided is SpatialCloud USA, which is typically licensed using the flexible Creative Commons Attribution 3.0 Unported terms when subscribed to. If implementing this Route-Me code in your application, please visit SpatialCloud.com and setup your own account, subscribe to the MapSource(s), & create your own MapStream(s). If the demo is abused SpatialCloud may be forced to disable this demo for all.";
+}
+
+@end
--- a/MapView/MapView.xcodeproj/project.pbxproj
View file @eb41b80
+++ b/MapView/MapView.xcodeproj/project.pbxproj
View file @eb41b80
@@ -40,6 +40,9 @@
 		25757F4F1291C8640083D504 /* RMCircle.h in Headers */ = {isa = PBXBuildFile; fileRef = 25757F4D1291C8640083D504 /* RMCircle.h */; };
 		25757F501291C8640083D504 /* RMCircle.m in Sources */ = {isa = PBXBuildFile; fileRef = 25757F4E1291C8640083D504 /* RMCircle.m */; };
 		25757F521291C8850083D504 /* RMCircle.m in Sources */ = {isa = PBXBuildFile; fileRef = 25757F4E1291C8640083D504 /* RMCircle.m */; };
+		2599740912EB966400816331 /* RMSpatialCloudMapSource.h in Headers */ = {isa = PBXBuildFile; fileRef = 2599740712EB966400816331 /* RMSpatialCloudMapSource.h */; };
+		2599740A12EB966400816331 /* RMSpatialCloudMapSource.m in Sources */ = {isa = PBXBuildFile; fileRef = 2599740812EB966400816331 /* RMSpatialCloudMapSource.m */; };
+		2599740B12EB967600816331 /* RMSpatialCloudMapSource.m in Sources */ = {isa = PBXBuildFile; fileRef = 2599740812EB966400816331 /* RMSpatialCloudMapSource.m */; };
 		2B2BADD70FA3B45A00EE37AA /* marker-X.png in Resources */ = {isa = PBXBuildFile; fileRef = 2B2BADD60FA3B45A00EE37AA /* marker-X.png */; };
 		2B5682720F68E36000E8DF40 /* RMOpenAerialMapSource.h in Headers */ = {isa = PBXBuildFile; fileRef = 2B5682700F68E36000E8DF40 /* RMOpenAerialMapSource.h */; };
 		2B5682730F68E36000E8DF40 /* RMOpenAerialMapSource.m in Sources */ = {isa = PBXBuildFile; fileRef = 2B5682710F68E36000E8DF40 /* RMOpenAerialMapSource.m */; };
@@ -231,6 +234,8 @@
 		23A0ABA90EB923AF003A4521 /* RMLatLong.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = RMLatLong.h; sourceTree = "<group>"; };
 		25757F4D1291C8640083D504 /* RMCircle.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = RMCircle.h; sourceTree = "<group>"; };
 		25757F4E1291C8640083D504 /* RMCircle.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = RMCircle.m; sourceTree = "<group>"; };
+		2599740712EB966400816331 /* RMSpatialCloudMapSource.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = RMSpatialCloudMapSource.h; sourceTree = "<group>"; };
+		2599740812EB966400816331 /* RMSpatialCloudMapSource.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = RMSpatialCloudMapSource.m; sourceTree = "<group>"; };
 		288765A40DF7441C002DB57D /* CoreGraphics.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = CoreGraphics.framework; path = System/Library/Frameworks/CoreGraphics.framework; sourceTree = SDKROOT; };
 		2B2BADD60FA3B45A00EE37AA /* marker-X.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; name = "marker-X.png"; path = "../marker-X.png"; sourceTree = "<group>"; };
 		2B2BD41D0F79A95500B8B9A7 /* README-static-library-build.rtf */ = {isa = PBXFileReference; lastKnownFileType = text.rtf; path = "README-static-library-build.rtf"; sourceTree = "<group>"; };
@@ -610,6 +615,8 @@
 				B885ABB10EBB1332002206AB /* RMCloudMadeMapSource.m */,
 				2B5682700F68E36000E8DF40 /* RMOpenAerialMapSource.h */,
 				2B5682710F68E36000E8DF40 /* RMOpenAerialMapSource.m */,
+				2599740712EB966400816331 /* RMSpatialCloudMapSource.h */,
+				2599740812EB966400816331 /* RMSpatialCloudMapSource.m */,
 			);
 			name = "Tile Source";
 			sourceTree = "<group>";
@@ -791,6 +798,7 @@
 				D1437B35122869E400888DAE /* RMDBTileImage.h in Headers */,
 				D1437B37122869E400888DAE /* RMDBMapSource.h in Headers */,
 				25757F4F1291C8640083D504 /* RMCircle.h in Headers */,
+				2599740912EB966400816331 /* RMSpatialCloudMapSource.h in Headers */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
@@ -985,6 +993,7 @@
 				46B1C067117653930062018A /* GTMNSNumber+64Bit.m in Sources */,
 				46B1C075117653F10062018A /* GTMObjC2Runtime.m in Sources */,
 				25757F521291C8850083D504 /* RMCircle.m in Sources */,
+				2599740B12EB967600816331 /* RMSpatialCloudMapSource.m in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};