Map is a very powerful but simple feature to use. It places a fully interactive Apple map onto a page. The map can be of one place or a list of places supplied in a .csv file (Excel) - for example a store finder. Additionally the pins on the map can link to an a page or email.
Maps can be included within a hotspot on any PDF. To include a default map, which will just display a map positioned over North America just create a hotspot with ‘Map’ as the URL. If you want to provide more detail, you have several options, you can tell the map to position it at a given locations, zoom level, map type (hybrid, satellite etc).
Point on your map
You can also provide CSV file, which contains all your Points of Interest (POI). These are simply latitude and longitude values for any location that you want to appear as a pinpoint on the map (The above video shows how to find Longitude and Latitude points). Within this CSV file you can also specify a note, or a link that will appear when you tap on that location in the map. These links can bring you to a webpage, or to compose an email, or even will allow you to jump to another map.
To format the URL you can use the following format:
- [NUMBER] denotes the referencing resource folder.
- [LATITUDE] the latitude value for the point that you want the map to position itself when the user first views the map.
- [LONGITUDE] the longitude value for the point that you want the map to position itself when the user first views the map.
- [ZOOM] a number that denotes the zoom value. For city level would be 5.0. For street level 0.06. The default is 0.0. NOTE: It needs to be a positive value.
- [TYPE] the type of the map that is shown, you can choose from the following three options.
- Standard or Map (default if this field is empty)
Example: Map2, 40.0, 0.0 ,2.1, Hybrid
The CSV file can be called anything, providing that the file extension is .csv. Place this file into the referenced folder, e.g. the referencing folder would be Map2 for the above folder. The fields that need to be filled in are 1 = Latitude, 2 = Longitude, 3 = Annotation Title, 4 = Link (optional).
Annotation title (3) is what appears when you tap on the location given by 1 and 2 (Lat, Long). The optional link (4) can be a weblink, email, another page or section, another map etc.
This shows an example of what the CSV would contain:
39.504041, -0.373535, “Email Link”, firstname.lastname@example.org/help 39.266284, 0.483398, This is just the name 39.265284, 0.473400, Cover, PCover-1
|Hotspot options||number, latitude, longitude, zoom, type|
|Position in Hotspot||Centre|
|Content resizes to fill hotspot||Scales to fill|
|Folder Name||Map1 (2,3 etc)|
|Examples||QA Oomph Walkthough/Oomph_Walkthough/Map|
|Transparent background allowed||No|
The map object does not support directions, however you can give directions by placing a web hotspot on the page with the directions.
You can append
&dirflg=h to the end of the URL to avoid highways.
iPad Preview Files
To view these files on your iPad click here to download Oomph Viewer onto your iPad. Once Oomph Viewer is installed download the Handy Book of Oomph in the Library section and preview all the Oomph features in one issue.
Got a question?