Movement SDK Documentation

Overview

The Movement SDK allows developers to access Foursquare’s location services for applications on the Android platform. The SDK includes various components for managing journeys, locations, geofences, and notifications.

Key Classes and Interfaces

• FoursquareLocation: Represents a specific location within the Foursquare database.
• Journey: Manages a user's journey, including its status and destination.
• Geofence: Defines virtual perimeters for real-world geographic areas.

Journey Statuses

• PENDING: The journey has been initiated but not yet started.
• IN_PROGRESS: The journey is currently active.
• APPROACHING: The user is nearing the destination.
• ARRIVED: The user has reached the destination.
• COMPLETED: The journey has concluded.
• CANCELED: The journey was aborted.

Geofence Types

• VENUE: Represents a physical location.
• LATLNG: Specifies a latitude and longitude pair.
• POLYGON: Defines a geofence with a polygonal shape.

Error Handling

Common Exceptions

• LocationNotAvailable: Thrown when location data is not retrievable.
• NetworkError: Indicates a network connection issue.

Logging Levels

• DEBUG: Detailed logs for troubleshooting.
• INFO: General information logs.
• WARN: Warning messages that may require attention.
• ERROR: Serious issues that require immediate attention.

Example Code Snippet

val journey = Journey() // Create a new journey
journey.start() // Start the journey

Additional Resources

For further details on specific classes and methods, developers can refer to the linked documentation for comprehensive breakdowns and use cases.