Travo

💛 Your companion that will not make you feel lost when you go to a new city 🌆

What is Travo?

🤔Travo is your one stop travel companion when you visit a new place and feel lost just open our app and look for popular places nearby along with recommended places by user ratings. Travo utilizes Foursquare API to provide the user with a large collection of places near them alongside providing weather information using OpenWeather about the place they are going to visit.

When to use it

💡When visiting a new city, you will not feel lost as you can use the app to explore new locations in the city and view popular places near you. Or you can press the “Feeling lucky” button which will show a random location which is popular near you.

Getting Started

Starting off with Travo is easy as it can get but surely you do need some credentials to access the foursquare api and don't worry about it as I will guide you through the process.

1. Download or Clone the Travo repo from above.
2. After you've downloaded it make sure you open the Travo-App.xcworkspace file as it's incooperated with pods.
3. Since you are done with the initial process now we have to get a clientID & clientSecret from FourSquare inorder to get access to their api which is being used.
4. Proceed to create an account with them and then create a new App associated with them in their dashboard which will be then used to generate the keys.
5. Then you can navigate to Model > RestRequest.swift and find the line 23 & 24 where you have to replace the clientID & clientSecret with your own keys which you generated earlier.
6. Whoooray 🎉 🎉 now you're done with the setting up part ... Finally run the app on your simulator or your device of your choice and enjoy having Travo as your travel companion.

Built With

• Swift - Swift is a powerful and intuitive programming language for macOS, iOS, watchOS, tvOS and beyond. Writing Swift code is interactive and fun, the syntax is concise yet expressive, and Swift includes modern features developers love.
  
• Foursquare API - The Foursquare Places API provides location based experiences with diverse information about venues, users, photos, and check-ins. The API supports real time access to places, Snap-to-Place that assigns users to specific locations, and Geo-tag. Additionally, Foursquare allows developers to build audience segments for analysis and measurement. JSON is the preferred response format.
• Open Weather API - Simple and fast and free weather API from OpenWeatherMap you have access to current weather data, 5- and 16-day forecasts, UV Index, air pollution and historical data.
• Alamofire - Alamofire is a Swift-based HTTP networking library for iOS and macOS. It provides an elegant interface on top of Apple’s Foundation networking stack that simplifies a number of common networking tasks.Alamofire provides chainable request/response methods, JSON parameter and response serialization, authentication, and many other features.
• SwiftyJSON - SwiftyJSON makes it easy to deal with JSON data in Swift.

Authors

• Gayuru Gunawardena
• Sogyal Sherpa
• Jun Cheong

License ⚖️

• Travo is licensed under the MIT License.

_{Built with ❤︎ by Team iSwift for iPhone Software Engineering module 🔖}