Introduction

1. Overview
1. Terminology
1. Trip
The term Trip and Guide is used interchangeably and describe possible things to do and places to see on a trip with optional schedules.


2. Travel Guide
Travel guides describe possible things to do and places to see on a trip with optional schedules.


3. Travel Journal
Travel journals document what was actually done and seen on a trip at specific times.


4. Destination
Destinations are places about which a guide is about e.g. a city, multiple cities, a country etc.


5. Places
The term “Place” is used to generically refer to locations, paths, and areas, and all three appear together in the Places list.


6. Locations
Locations are points on the map e.g. hotel, attraction, etc.


7. Paths
Paths are lines on a map e.g. driving or walking directions


8. Areas
Areas are multiple locations on a map that define an area e.g., neighborhoods.


9. Groups
Groups and categories together help to categorize places and enable searching and filtering. By convention, a group is at a higher level. For example, you can have a group be a neighborhood (e.g., downtown) and a category be a restaurant. So that you can easily find all the “restaurants downtown”. A place can have multiple groups and multiple categories. For example, a second category can be Italian restaurant, so that you can easily find all restaurants, or all the “Italian restaurants downtown”.


10. Categories
See Groups above.


11. Event
An event is an activity with; a start and end date and time. For example, “Lunch on July 12 between 12 and 1”.  An event can have multiple places associated with it. An event can contain user specified HTML content. A guide can have multiple events. Events belong to a specific schedule.


12. Schedule
A Guide has one default schedule called “Main”, and other schedules can be added. A schedule contains one or more events. For example, “One-day Tour”, “Two-day Tour” etc.


13. Itinerary
An Itinerary is the HTML version of a schedule, which is scrollable, zoomable, interactive and editable.


14. Chapters
A book contains chapters, which contain sections. Andiamo Places uses the book metaphor to organize HTML content. Sections are used to store HTML content and chapters are convenient folders to store the sections in. The chapters are for the benefit of the guide creator and the user does not really interact with them. The guide user sees the content which the guide creator makes available to the user via HTML and links to internal HTML (i.e. sections), or external HTML (i.e. URLs).


15. Sections
Sections are organized under chapters and is where the guide creator creates and stores HTML content that he later wants to show the user via HTML links.


2. Quick tour
1. The Andiamo Places app allows anyone to create Travel Guides & Travel Journals for Free. This is useful for trip planning, efficient trip execution, to document and archive what you did on the trip and to show your friends what you did on your trip.
2. When you first launch the app, you will be in “Guest Mode” because you have not registered or logged in.
3. In guest mode, you can view content and even make changes, but only locally because you cannot store any content in the cloud until we can identify who you are. Local content is lost when the app restarts.
4. To gain full functionality, you can register and login for free.
5. When logged in, you can create your own content by either copying an existing guide, using “Create copy of this Guide” in the “Create & Edit” menu or creating a new guide, using “Create new blank Guide” in the “Create & Edit” menu.
6. To learn how to add content to a guide see section on Create a New Guide
7. The starting screen of the app is the Home screen (also called the Itinerary screen). The Home screen contains HTML content that you can edit. It can be used as a launching pad for other HTML content e.g. Table Of  Contents, or as the main HTML content e.g. Journal. It is most commonly used to store the itinerary.
8. You can view a list of the places in the”Places” screen. From here you can filter places, sort places or add new places.
9. You can see the places on a map in the “Map” screen. From here you can filter places, add new places, search for new places and interact with the map.
10. You can see the schedules and events in the “Schedules” screen. From here you can filter events, add events, manage different schedules etc.
11. You can purchase travel related tickets from the “Partners Offers” in the main menu.


3. Navigation
The top navigation bar is used to navigate between the main application screens: Itinerary, Places, Map, and Schedules. Navigation is also possible when clicking on some HTML links, or when selecting menu items. Note that for most dialogs, the back arrow at the upper left is to cancel and exit, the check mark is to make the changes and exit.


2. Login
1. Guest Mode
When you launch the Andiamo Places mobile app. If you are not logged in, you are in guest mode. As a guest, you can do almost anything that a logged in user can do, but since we don’t know who you are, you cannot do anything that requires saving changes to the cloud. For example, Save guide, Copy guide, New guide and review guide.


2. Register
You do not need to register to view guides, however you do need to register and then login to create and save your own guides


3. Login
Before you can login you need to register. You do not need to login to view guides; however, you do need to login to create and save your own guides


4. Logout
You can logout for additional security. The app remembers login status across restarts.


5. Reset Password
If you forget your password, you can reset it.


6. User details
The user details screen displays user information like user id, email, first name and last name.


7. Settings
From Settings you can set preferences like; distance unit, date format, edit mode, and advanced mode.


3. Itinerary/Home Screen
The Itinerary screen (also know as the Home screen) is HTML which is customizable by the user. The content creator can edit the HTML and add links or embedded content. Common uses for the “Home” page are; table of contents or main content of the journal. Note that HTML can link to other HTML by using links to sections.
4. Places Screen
The places screen contains a list of places (remember that includes paths and areas). From this screen one can filter by text, add new places, filter places and sort places.
5. Map Screen
The map screen displays the places on a map (remember that includes paths and areas). From this screen one can filter by text, add new places, filter places, and interact with the map.
6. Schedule Screen
The schedules screen displays the events for the selected schedule. Events can be filtered by text; new events can be added and existing events can be modified.

7. How to
1. Register
1. Click on the User icon at the bottom right
2. Cick on “Sign In”
3. Click on “Register here”


2. Login
1. Click on the User icon at the bottom right
2. Cick on “Sign In”


3. Logout
1. Click on the User icon at the bottom right
2. Cick on “Sign Out”


4. Reset Password
1. Click on the User icon at the bottom right
2. Cick on “Sign In”
3. Click on “Forgot Password?


5. Select a Guide to View
1. Click the “Library” icon at the bottom
2. Select either “Viewed”, “Mine”, “Featured”, “Shared” or “Device”.
3. Click on the desired guide


6. Create new Empty Guide
1. Click on the the Main Menu
2. Click on “Create & Edit”
3. Click on “Create new blank Guide”
4. Enter information about the Guide like the name
5. Click Save


7. Copy a Guide
1. Click on the the Main Menu
2. Click on “Create & Edit”
3. Click on “Create copy of this Guide”


8. Create a Guide using ChatGPT artificial intelligence
1. Click on the the Main Menu
2. Click on “Create & Edit”
3. Click on “Create Trip w/AI”
4. Enter options
5. Click Create


9. Create Walks using ChatGPT artificial intelligence
1. Click on the the Main Menu
2. Click on “Create & Edit”
3. Click on “Create Walks w/AI”
4. Enter options
5. Click Create


10. Get answers from ChatGPT
1. Click on the Main Menu
2. Click on “Travel Wizard”
3. Select the optionsi.e.number, proximity, city, and country
4. Select Question


11. Create Journal from Photos
1. Click on the the Main Menu
2. Click on “Create & Edit”
3. Click on “Create Jurnal from Photos”
4. Clck on “Select Photos”
5. Select if from Andiamo cloud or Google Dive


12. Import KML, KMZ, GPX and TCX files
1. Click on the the Main Menu
2. Click on “Import & upload”
3. Click on “Import KML/KMZ/GPX/TCX”
4. Select the file from the dialog


13. Add places to the guide in several ways
1. “Add Place” in the Places screen (enter data in dialog)
2. “Add Places” in the Places screen (Type or paste a list of CSV or JSON places)
3. “Add Place” in the Map screen (enter data in dialog)
4. “Search Places” in the Map screen and then add search results
5. Clicking on POIs in the Google map
6. Clicking anyplace on the map
7. Copy them from an existing guide in the library
8. Import them from KML, KMZ, GPX or TCX files
9. Import them from an exported trip
10. Import them from Google Maps List
11. in the web version click on the drawing palette in the map and then clcick anywhere on the map. Select “Stop Drawing” to stop.
14. Add events to Guide in several ways
1. “+” in the Schedule header
2. “Add Event Before” in the event menu
3. “Add Event After” in the event menu
4. “Bulk Add Events” (Type or paste a list of CSV or JSON events)
15. Create a New Guide Manually
1. Copy an existing guide or create a new empty guide
2. Edit guide info (at least: name, image and base location)
3. Make a list of places by searching the internet for suggestions or use the search feature in the app.
4. Add places to Guide
5. Add events to schedule
6. Edit Itinerary or create one from the schedule menu
7. Remember to click on “save” periodically to save changes to the cloud.


16. Rate Guide
1. To review a Guide you first need to download it (i.e. search and view the guide)
2. From the main Menu click on the “Guide Menu”
3. Select “Rate this Guide”
4. Provide a numerical rating by dragging your finger on the stars
5. Provide a text comment
6. Click on “Done” when finished or back arrow to cancel
7. Note that only one review is allowed per user. You can modify a review if you have already submitted one.


17. Edit Place
1. From the places list click on the pencil icon for the place to be edited, or the menu icon and then select “Edit attributes”


18. Add Path
1. Same as adding a Place, but select the “Add a Line” icon and then select a path by clicking on several spots on map.
2. Select “Stop Drawing” from the drawing palette


19. Add Area
1. Same as adding a Place, but select “Add a Shape” icon and then select an area by clicking on several spots on map.
2. Select “Stop Drawing” from the drawing palette


20. Sharing a Link to the Guide
1. Click on the Main Menu
2. Select “Export & Share”
3. Select the sharing method
21. Edit Itinerary
1. From the “Itinerary” screen click on the “Edit” icon
2. Make changes to the HTML
3. Click on the check mark or “Save” icon


22. Upload Images
1. Click on the Main Menu
2. Click on “Import & Upload”
3. Click on “Upload Images”.
4. Before uploading you can choose the folder
5. After uploading you can set the image name (Not required)
23. To replace the stock photos with your photos
1. From Places screen click on the 3 dot horizontal menu
2. Click on “Content”
3. Click on “Use My Photos”
4. Select photo source: Andiamo Cloud or Google drive.
5. With Google Drive you will need to login to your account
6. Select all of the photos (Note: on the web version you can select multiple photos with a couple of clicks, but in the mobile version you need to select each one).
7. The app will provide a list of likely photos for the places based on distance from the place.
8. Select the best photos for the places.
24. To replace the stock photos with your photos
1. From Places screen click on the 3 dot horizontal menu
2. Click on “Content”
3. Click on “Use My Photos”
4. Select photo source: Andiamo Cloud or Google drive.
5. With Google Drive you will need to login to your account
6. Select all of the photos (Note: on the web version you can select multiple photos with a couple of clicks, but in the mobile version you need to select each one).
7. The app will provide a list of likely photos for the places based on distance from the place.
8. Select the best photos for the places.
25. To add additional photos to Places
1. From the Places screen click on the 3 dot horizontal menu
2. Click on “Content”
3. Click on “Add Photos to Places”
4. Select photo source: Andiamo Cloud or Google drive.
5. With Google Drive you will need to login to your account
6. Select all of the photos (Note: on the web version you can select multiple photos with a couple of clicks, but in the mobile version you need to select each one).
7. The app will provide a list of likely photos for the places based on distance from the place.
8. Select the best photos for the places.