CloudSight API library for Objective-C. Extracted from CamFind-iOS.
CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries like CloudSight in your projects.
pod "CloudSight", "~> 1.0"The CloudSight library uses the OAuth1 authentication method to the API. Make sure your key and secret are set.
[CloudSightConnection sharedInstance].consumerKey = @"your-key";
[CloudSightConnection sharedInstance].consumerSecret = @"your-secret";The easiest way to use the API is to use a Query object to handle the request/response workflow work for you.
@interface ViewController ()
@property (nonatomic, retain) CloudSightQuery *query;
@end
- (void)searchWithImage:(UIImage *)image {
NSString *deviceIdentifier = nil; // This can be any unique identifier per device, and is optional - we like to use UUIDs
CLLocation *location = nil; // you can use the CLLocationManager to determine the user's location
// We recommend sending a JPG image no larger than 1024x1024 and with a 0.7-0.8 compression quality,
// you can reduce this on a Cellular network to 800x800 at quality = 0.4
NSData *imageData = UIImageJPEGRepresentation(image, 0.7);
// Create the actual query object
self.query = [[CloudSightQuery alloc] initWithImage:imageData
atLocation:focalPoint
withDelegate:self
atPlacemark:location
withDeviceId:deviceIdentifier];
// Start the query process
[self.query start];
}
#pragma mark CloudSightQueryDelegate
- (void)cloudSightQueryDidFinishIdentifying:(CloudSightQuery *)query {
if (query.skipReason != nil) {
NSLog(@"Skipped: %@", query.skipReason);
} else {
NSLog(@"Identified: %@", query.title);
}
}
- (void)cloudSightQueryDidFail:(CloudSightQuery *)query withError:(NSError *)error {
NSLog(@"Error: %@", error);
}There's a working Obj-C example that you can run by opening Example-objc/CloudSightExample.xcworkspace in XCode.
CloudSight is released under the MIT license.