//
//  VPPForwardGeoLocation.h
//
//  Created by Víctor on 31/10/11.

// 	Copyright (c) 2012 Víctor Pena Placer (@vicpenap)
// 	http://www.victorpena.es/
// 	
// 	
// 	Permission is hereby granted, free of charge, to any person obtaining a copy 
// 	of this software and associated documentation files (the "Software"), to deal
// 	in the Software without restriction, including without limitation the rights 
// 	to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
// 	copies of the Software, and to permit persons to whom the Software is furnished
// 	to do so, subject to the following conditions:
// 	
// 	The above copyright notice and this permission notice shall be included in
// 	all copies or substantial portions of the Software.
// 	
// 	THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// 	IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
// 	FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// 	AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
// 	WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
// 	IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


#import <Foundation/Foundation.h>

/** VPPForwardGeoLocation is a block-based library that can get locations
from a given search string, something like iOS Maps application. 

Locations will be instances of VPPForwardGeoLocationAnnotation class. */
@interface VPPForwardGeoLocation : NSObject

/** Performs a background request and calls block in the main thread 
passing the locations found as parameter.

@param addressString The string to search.
@param batchSize Max amount of locations to return.
@param block The block to be called when the search is finished. `data` 
will hold the locations found as an array of VPPForwardGeoLocationAnnotation
instances. It will be `nil` if an error occurs or no location is found. */
+ (void) locationsUsingForwardGeoLocation:(NSString*)addressString 
                                batchSize:(int)batchSize 
                               completion:(void (^) (NSArray *data))block;

@end
