Inherits from NSObject
Declared in LULocationRequestFactory.h
LULocationRequestFactory.m

Overview

LULocationRequestFactory builds requests to retrieve locations.

Class Methods

requestForAppLocationsNearLocation:

Builds a request to return the first page of locations for merchants associated with the app.

+ (LUAPIRequest *)requestForAppLocationsNearLocation:(CLLocation *)location

Parameters

location

The location to use for sorting.

Discussion

Builds a request to return the first page of locations for merchants associated with the app.

On success, this request will full LULocation instances for each location, sorted relative to the distance from the given location. The response will include a URL for the next page of results. This URL is retrieved by calling nextPageURL on the LUAPIResponse instance that is returned along with the results. This URL can be used with requestForLocationsOnPage: to retrieve the next page of locations.

Declared In

LULocationRequestFactory.h

requestForAppLocationsOnPage:

Builds a request to return the given page of locations for merchants associated with the app.

+ (LUAPIRequest *)requestForAppLocationsOnPage:(NSURL *)pageURL

Parameters

pageURL

The next page of locations to request.

Discussion

Builds a request to return the given page of locations for merchants associated with the app.

On success, this request will full LULocation instances for each location. If this page doesn’t include any locations, the response will be an empty array. When there are additional pages of results, the LUAPIResponse will also include the URL for the next page of results.

Declared In

LULocationRequestFactory.h

requestForLocationSummaries

Builds a request to return the first page of location summaries.

+ (LUAPIRequest *)requestForLocationSummaries

Discussion

Builds a request to return the first page of location summaries.

On success, this request will return an array of LULocation instances in summary mode. Locations are returned in the order that were updated (ascending). The response will include a URL for the next page of results. This URL is retrieved by calling nextPageURL on the LUAPIResponse instance that is returned along with the results. This URL can be used with requestForLocationSummariesOnPage: to retrieve the next page of locations. In this way, the app can keep a local database of all LevelUp locations, and keep the database up to date.

Declared In

LULocationRequestFactory.h

requestForLocationSummariesOnPage:

Builds a request to return the given page of location summaries.

+ (LUAPIRequest *)requestForLocationSummariesOnPage:(NSURL *)pageURL

Parameters

pageURL

The next page of location summaries to request.

Discussion

Builds a request to return the given page of location summaries.

On success, this request will return an array of LULocation instances in summary mode. If this page doesn’t include any locations, the response will be empty with a status code of 204 (No Content). This URL can then be retried, and when results are available they will be returned. When there are additional pages of results, the LUAPIResponse will also include the URL for the next page of results.

Declared In

LULocationRequestFactory.h

requestForLocationWithID:

Builds a request to return the details for a specific location.

+ (LUAPIRequest *)requestForLocationWithID:(NSNumber *)locationID

Parameters

locationID

The location ID to request.

Discussion

Builds a request to return the details for a specific location.

On success, this request will return a LULocation instance for the specified ID. If there isn’t a location with that id, the response will be empty with a status code of 404 (Not found).

Declared In

LULocationRequestFactory.h

requestForMerchantLocationsNearLocation:forMerchantID:

Builds a request to return the first page of merchant locations for multi-merchants associated with the app.

+ (LUAPIRequest *)requestForMerchantLocationsNearLocation:(CLLocation *)location forMerchantID:(NSNumber *)merchantID

Parameters

location

The location to use for sorting.

merchantID

The merchant id.

Discussion

Builds a request to return the first page of merchant locations for multi-merchants associated with the app.

On success, this request will return LULocation instances for each location, sorted relative to the distance from the given location. The response will include a URL for the next page of results. This URL is retrieved by calling nextPageURL on the LUAPIResponse instance that is returned along with the results. This URL can be used with requestForMerchantLocationsOnPage: to retrieve the next page of locations.

Declared In

LULocationRequestFactory.h

requestForMerchantLocationsOnPage:

Builds a request to return the given page of merchant locations for multi-merchants associated with the app.

+ (LUAPIRequest *)requestForMerchantLocationsOnPage:(NSURL *)pageURL

Parameters

pageURL

The next page of locations to request.

Discussion

Builds a request to return the given page of merchant locations for multi-merchants associated with the app.

On success, this request will return LULocation instances for each location. If this page doesn’t include any locations, the response will be an empty array. When there are additional pages of results, the LUAPIResponse will also include the URL for the next page of results.

Declared In

LULocationRequestFactory.h

requestForWebLinksAtLocationWithID:

Builds a request to return the web links associated with a specific location.

+ (LUAPIRequest *)requestForWebLinksAtLocationWithID:(NSNumber *)locationID

Parameters

locationID

The location ID to request.

Discussion

Builds a request to return the web links associated with a specific location.

On success, this request will return an array of LUWebLink instances.

Declared In

LULocationRequestFactory.h