Introduction for Web version
  1. Overview
    1. Terminology
      1. Travel Guide
        2. Travel guides describe things to do and places to see on a trip.

      2. Travel Journal
        3. Travel journals document what was actually done and seen on a trip.

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

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

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

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

      7. Areas
        8. Areas are shapes on a map that define an area e.g., neighborhoods.

      8. Groups
        9. 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".

      9. Categories
        10. See Groups above.

      10. Event
        11. 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. Note that there are advantages to only specifying one place per event e.g. the itinerary automatically includes directions from place to place.

      11. Schedule
        12. 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.

      12. Itinerary
        13. An Itinerary is the HTML version of a schedule, which is scroll-able, zoom-able and interactive.

      13. Chapters
        14. Andiamo Places uses the book metaphor to organize HTML content. Chapters are like folders to store the HTML content. The chapters are for the benefit of the guide creator and the user does not interact with them.

      14. Sections
        15. Sections contain the HTML content. 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

    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
      4. 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 know who the owner of the content is. Local content is lost when the app restarts.
      5. To gain full functionality, you can register and login for free.
      6. When logged in, you can create your own content by either copying an existing guide, using "Copy Guide" (if you have the access rights) or creating a new guide, using "New Guide".
      7. To learn how to add content to a guide see section on Create a New Guide
      8. The main screen of the app is the Home screen. The Home screen contains HTML content that you can edit. It can be used as a starting point for other HTML content e.g. Table Of  Contents, or as the main HTML content e.g. Journal.
      9. You can view a list of the places in the"Places" list. From here you can filter places, sort places or edit places.
      10. 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.
      11. You can see the schedules and events in the"Schedules" screen. From here you can filter events. add events, manage different schedules etc.
      12. You can purchase travel related tickets from the "Tickets" screen. This is not mandatory, but the commission we get from your purchases helps to keep the app free. ChatGPT and google cost money.

  2. Login
    1. Guest Mode
      2. 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
      3. 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. Registration is free.

    3. Login
      4. 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
      5. You can logout to add security to the guides that you own. For example if you are using someone else's computer to access them.

    5. Forgot Password/Reset Password
      6. If you registered by providing a password and you forget your password, we can reset it.

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

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

  3. Home Screen
    4. The home screen is HTML and is customizable by the user. The user 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.
    1. User
      1. Login
      2. Register
      3. Logout
      4. Reset Password
      5. User details
      6. Content Font Zoom
      7. Settings
      8. Upload Images

    2. Guide
      1. Refresh Guide (reads the same guide from the cloud and overwrites any local changes)
      2. Travel Wizard (answers common travel questions)
      3. Guide Creator (uses ChatGPT AI to create a complete guide in minutes)
      4. Create Journal from Photos (creates a travel journal from your trip photos, if they have date and location)
      5. Rate this Guide (Give the current guide a rating, one rating per user)
      6. Guide Info (displays information about the guide)
      7. Email guide link (email a link to the current guide)
      8. Display Guide Link (Display the URL link to the current guide)
      9. Guide Settings (customize how you interact with guide)
      10. Translate Guide (translate the text in the guide to one of 133 languages)
    3. Edit
      1. Edit Home content (edit the content of the home screen)
      2. Edit Chapters/Sections (sections store HTML content, chapters organize sections)
      3. Edit Groups (Modify the groups that the place belongs to)
      4. Edit Categories (Modify the categories that the place belongs to)
      5. Custom Map Markers (Create or edit a map marker)
      6. Edit Guide Properties (Edit guide properties like name, image, access rights etc.)
    4. File
      1. Save Guide to cloud (Saves the guide to the cloud)
      2. New Guide (Creates a new guide. Make sure that you first save any changes to the current guide)
      3. Copy Guide (Makes a copy of the current guide and opens the new guide, uses the current guide name and adds "_C"
      4. Overwrite Guide (Overwrites the content of selected guide with the contents of the current guide)
      5. Export Places as KML (exports the places in the guide to a KML file)
      6. Import Places from KML/KMZ/GPX/TCX (Imports places from one of the supported file formats)

    5. Info
      1. About (General information about Andiamo Places)
      2. Help Videos (Links to help videos)
      3. FAQs (Answers to frequently asked questions)
      4. Help (This help document)
      5. Guidelines (Dos and don't that users to abide by)
      6. Web Site (Link to the Andiamo web site)
      7. Contact us (Send us an email to report issues, provide feedback or anything else)

  4. Places Screen
    5. 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. When the places are filtered, the filter icon color changes to yellow.
    1. Back arrow (Go back to previous screen)

    2. Edit
      1. Add to Groups (Add the selected places to one or more groups)
      2. Remove from Groups (Remove the selected places to one or more groups)
      3. Set to Groups (Set the selected places to one or more groups)
      4. Add to Categories (Add the selected places to one or more categories)
      5. Remove from Categories (Remove the selected places to one or more groups)
      6. Set to Categories (Set the selected places to one or more groups)
      7. Mark Places Favorite (Mark the selected places as "Favorite")
      8. Mark Places Visited (Mark the selected places as "Visited")
      9. Mark Places as 'Must See' (Mark the selected places as "Must See")
      10. Show/Hide Places (Hide or show the selected places)
      11. Create Events from Places (Create a schedule from the selected places)
      12. Set Place Link (Set the place link for all of the selected places)
      13. Delete Places (Delete all of the selected places)

    3. Filter
      1. Text Filter(Filter the paces based on a text string)
      2. Only Favorites (Only display the Favorite places)
      3. Only Visited (Only display the Visited places)
      4. Only Not Visited (Only display the places not visited)
      5. Only Must See (Only display the 'Must See' places)
      6. Only Search Results (Only display the places from a search)
      7. Filter by days (Only display the places scheduled for specific days)
      8. Filter by Schedules (Only display the places in a specific schedule)
      9. Filter by Places (Only display selected places)
      10. Filter by Place Type (Only display the type of places selected e.g. location, path or area)
      11. Filter by Groups (Only display the the places in the selected groups)
      12. Filter by Categories (Only display the the places in the selected categories)
      13. Filter by Distance (Only display the the places within the selected distance)
      14. Hide Search Results (Hide the places from search)
      15. Hide Specific Groups (Hide the places in the selected groups)
      16. Show hidden places (Show places even if they are designated as 'Hidden')
      17. Show All

    4. Sort
      1. Sort by Name (Sort the places in the list by name)
      2. Sort by Category (Sort the places in the list by category)
      3. Sort by Group (Sort the places in the list by group)
      4. Sort by Rating (Sort the places in the list by rating)
      5. Sort by Distance (Sort the places in the list by distance)
      6. Sort by Date (Sort the places in the list by date)

    5. Place Menu
      1. Center in Map (center this place in the map)
      2. Directions from here (use this place as the starting location for directions)
      3. Directions add waypoint (Add this place to the list of waypoint for directions)
      4. Directions to here (use this place as the destination for directions)
      5. Show Street View (Show the street view near this place)
      6. Show Weather Forecast (Show the weather forecast at this places location)
      7. Show in Google Maps (Show this location of this place in google Maps)
      8. Show Images from Web (Show images about this place in browser)
      9. Show Videos from Web (Show videos about this place in browser)
      10. Show Articles from Web (Show articles about this place in browser)
      11. Show Location Attributes (Show all attributes about this place)
      12. Show Location Info (Show only the info about this place
      13. Copy Photo to Place (Copy the photo from this place to another place)
      14. Set as current location (Set as current location used for measuring distances)
      15. Add location to schedule (create an event using this place)
      16. Edit attributes (Edit this place)
      17. Combine Places info (Combine the info from this place with another place)
      18. Delete Location (Delete place)

  5. Map Screen
    6. 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, and interact with the map.
    1. Search
      1. Google text Search (uses google to find places based on text)
      2. Google category search (uses google to find places based on category)
      3. Wikipedia text search (uses Wikipedia to find places based on text)
      4. Flickr text search (uses google to find places based on text)
      5. AI Search (uses ChatGPT AI and google to find places based on text)
      6. Search in Foursquare app (opens the Foursquare app and searches for places based on map location)
      7. Search in Yelp app (opens the Yelp app and searches for places based on map location)
      8. Search in Happy Cow app (opens the Happy Cow app and searches for vegan restaurants based on map location)
      9. Add all Search results (Adds all search results to the guide)
      10. Remove all Search results (removes all search results from map)

    2. Menu
      1. Get current location (Display the current latitude/longitude of center of map)
      2. Center to current Location (centers the map to your current physical location)
      3. Track my location (Periodically updates the center of the map based on your current physical location)
      4. Fit All Places (Resize the map so that all of the current places are visible)
      5. Get Directions (Shows the directions dialog)
      6. Import KML/KMZ/GPX/TCX file (Import places from a file)
      7. Create Places from Photos (Creates places from a selected list of places that contain location info)
      8. Show Directions Menu (Shows the directions dialog)

    3. Drawing Palette
      4. The drawing palette is used to add places, paths and areas. To add:
      1. Click on the place, path or area icon to start drawing mode
      2. Click on map once for place
      3. Click on map in multiple places for path and for area, and double click to finish
      4. Click on hand to stop drawing mode

    4. Map Menu
      5. When you click anywhere on a map you will see the map menu
      1. Display coordinates clicked (Display the latitude/longitude of place clicked on map)
      2. Set Guide base location (sets the base location of the guide used for displaying guide on map
      3. Add location here (ads a place at the clicked location)
      4. Get weather forecast (get weather forecast for place clicked on map)
      5. Directions from here (Set clicked location as starting point for directions)
      6. Directions add waypoint (Set clicked location as a waypoint for directions)
      7. Directions to here (Set clicked location as destination point for directions)
      8. Ask a travel question (ask a travel related question)

    5. POI Menu
      6. When you click on a point of interest (POI) you will see the POI menu
      1. View POI in google maps (Launch google maps app and display info on this POI)
      2. Add POI to guide (Add this POI as a place in the guide)

  6. Schedule Screen
    7. 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.
    1. Filter (Filter events by text)

    2. Add (Displays the add event dialog)

    3. Menu
      1. Choose Schedule (Choose which schedule to display)
      2. Delete Schedule (Delete a schedule)
      3. Add Schedule (Add a new schedule)

    4. Schedule Menu
      1. Show Itinerary(Displays schedule in HTML format)
      2. Change Start Date (Change the start date of the schedule)
      3. Add Events to Schedule (Adds all events from schedule to current selected schedule)
      4. Add Events from Schedule(s) (Adds all events from selected schedules to current schedule)
      5. Rename Schedule (Renames the schedule)
      6. Optimize Schedule by location (Optimizes schedule by arranging events based on proximity)

    5. Event Menu
      1. Center in Map (centers the places in the event in map)
      2. Filter places in event (centers the places in the event in map and only shows those )
      3. Show Details (Displays the event details)
      4. Shift Events (Move events based on start times)
      5. Edit Event (Edit the event)
      6. Delete Event
      7. Add Event After (Add a new event after this one)
      8. Add Event Before (Add a new event before this one)
      9. Combine Events (Combine the info from multiple events.

  7. Tickets Screen
    8. The tickets screen displays the various links for purchasing travel tickets. There is no obligation to buy, but the small commission helps to keep this app free. ChatGPT and google cost money.

  8. How to
    1. Register
      1. From Home screen, click on User icon
      2. If "Register" is not in the list then you are already logged in
      3. Click on "Register

    2. Login
      1. From Home screen, click on User icon
      2. If "Login" is not in the list then you are already logged in
      3. Click on "Login"

    3. Logout
      1. From Home screen, click on User icon
      2. If "Logout" is not in the list then you are already logged out

    4. Reset Password
      1. From Home screen, click on User icon
      2. Click on "Reset Password"
      3. Enter your email address
      4. Click on "Forgot Password"

    5. Select a Guide to View
      1. From the Navigation bar at the bottom, click on the Guides icon
      2. If a list appears, select the type of guides from the list.
      3. If the Filter icon appears, select the type of guides from the list.
      4. Click on the download icon

    6. Create new Empty Guide
      1. From the Home screen click on the File icon
      2. Click on "New Guide"
      3. The new guide will be created
      4. Make sure to save it to the cloud

    7. Copy a Guide
      1. From the Home screen click on the File icon
      2. Click on "Copy Guide"
      3. The new guide will be opened
      4. Make sure to save it to the cloud

    8. Create a Guide using ChatGPT artificial intelligence
      1. From the Home screen click on the Guide icon
      2. Click on "Guide Creator"
      3. Select the options and click "Create"

    9. Get answers from ChatGPT
      1. From the Home screen click on the Guide icon
      2. Click on "Travel Wizard"
      3. Select the options i.e. number, proximity, city, and country
      4. Select Question

    10. Create Journal from Photos
      1. Note: photos must contain EXIF data (location and date)
      2. Note: before selecting the photos you can rename them to make the journal more readable
      3. From the Home screen click on the Guide icon
      4. Select the photos
      5. Click the checkmark

    11. Import KML, KMZ and GPX files
      1. From the "Map" screen click on the "+" icon
      2. Select "Import KML, KMZ..."
      3. Click on either KML/KMZ or GPX
      4. select file from device

    12. Create a New Guide Manually
      1. Copy an existing guide or create a new guide
      2. Edit guide info (at least: name, image and base location)
      3. Make a list of places (search the internet for suggestions. e.g. bing travel)
      4. Select the "Must See" places (from the places found, search internet for recommendations)
      5. Make a list of groups (from places list)
      6. Make a list of categories (from places list)
      7. Add/delete groups in guide. Select icon groups
      8. Add/delete categories in guide. Select icon for categories
      9. Add Locations to guide (from search, point on map, point of interest etc,
      10. Add Paths to guide from map
      11. Add Areas to guide from map
      12. Add groups, categories and "Must See" flag to places. Select icon only to override group and category icon.
      13. Note, you can use the 'Filter places in area" to expedite grouping and tagging
      14. Search for or create itineraries (e.g. from Bing travel)
      15. Add events to schedule
      16. Add place(s) visited during each event
      17. Create Chapters and Sections (optional, used as HTML content)
      18. Edit Home screen (optional, can be used like a table of contents for quick links to data or as the main travel journal)
      19. Set access level for guide if you want to let others view guide
      20. Remember to click on "save" periodically to save changes to the guide.

    13. Rate Guide
      1. To review a Guide you first need to download it (i.e. search and view the guide)
      2. From the "Home" screen click on the "Guide" icon
      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.

    14. Add Place
      1. From the "Map" screen click on the "+" icon
      2. Select "Add Place"
      3. Enter name
      4. Click on get location from map
      5. Select location by clicking on map or moving marker
      6. Click on the check mark
      7. Click on the check mark again

    15. Add Path
      1. Same as adding a Place, but select "Add path" and then select a path by clicking on several spots on map

    16. Add Area
      1. Same as adding a Place, but select "Add area" and then select an area by clicking on several spots on map

    17. Send email link
      1. From the "Home" screen click on the "Guide" icon
      2. Select "Email Guide Link"
      3. This willl launch your email program with the URL link
      4. Select who you want to send it to

    18. Send WhatsApp link
      1. From the "Home" screen click on the "Guide" icon
      2. Select "WhatsApp Guide Link"
      3. This will launch your WhatsApp program with the URL link
      4. Select who you want to send it to

    19. Add event
      1. From the "Schedule" screen click on the "+" icon
      2. Provide a Subject
      3. Select starting and ending date and time
      4. Selecting one or more existing places
      5. Provide optional event info
      6. Click on the check mark

    20. Edit Home Screen
      1. From the "Home" screen click on the "Edit" icon
      2. Select "Edit Home Screen"
      3. Make changes to the HTML
      4. Click on the check mark

    21. Upload Images
      1. There are 2 ways to upload images. Directly via "Upload Images" from "Guide" -> "Upload Images" or indirectly whenever you choose an image from a folder on your phone or from your camera
      2. Using the the first method, you first upload your photo and then in a second step you use it in your guide. In the second method, you choose your photo and it gets uploaded behind the scenes. To assign a name and folder, you still need to go to "Upload Images".
      3. When you upload images they go into folders which you can name.
      4. Before uploading you can choose the folder
      5. After uploading you can set the image name (Not required)

    22. Play the itinerary
      1. You can have the itinerary "played" one event at a time by pressing the triangle play icon in the schedule
      2. You can pause or stop by clicking on the pause or stop icons.

    23. Customize the user interface
      1. You can customize the user interface from the View menu
      2. Hide/Show list of places
      3. Hide/Show schedule
      4. Hide/Show home
      5. Hide/Show map
      6. Hide/Show side menu
      7. Content Font Zoom

    24. Customize how the guide responds to clicks
      1. Click on the "Guide" menu
      2. Click on "Guide Settings" menu item
      3. Enable or disable the desired features
      4. Click on the check mark

    25. Print Guide
      1. Click on the "Guide" menu
      2. Click on the Print/PDF menu item
      3. Select the printer
      4. Click on Print

    26. Save Guide to PDF
      1. Click on the "Guide" menu
      2. Click on the "Print/PDF" menu item
      3. Select "Save as PDF"
      4. Click on Save

    27. Translate Guide
      1. The guide can be translated into one of 133 languages
      2. Click on the "Guide" menu
      3. Click on the "Translate Guide" menu item
      4. Select what parts of the guide you want translated
      5. Select the language
      6. Click on the "translate" button

    28. Edit Home Content
      1. Click on the "Guide" menu
      2. Click on the "Edit Home Content" menu item
      3. Edit content
      4. Click on the floppy disk icon

    29. Report Issues or Provide Feedback
      1. Click on the "Info" menu
      2. Click on "Contact us"