Example: Locations

Save Locations and use saved Locations to quickly navigate to desired views in windows.


To fit into this documentation, illustrations show a small Manifold desktop, with only a few panes, docked to the right side.  In real life we use a much larger Manifold desktop, and more panes would be turned on, with panes docked to the left or to the right, or undocked, as we prefer.   Right-click a pane's tab to change where it is docked.  Manifold will remember that new arrangement for our next session.





We start with a project that has a map with two Bing image server layers, a street layer and a satellite layer, plus an OpenStreetMap (OSM) base map layer.  The map has six locations saved, all of which we have placed within a folder called Locations to avoid clutter in our Project pane.   The locations show the positions of various Gothic cathedrals in France.

Save a New Location




 To save the current location shown in the map, with the focus on the map we click on the Locations button and in the drop-down menu we choose Save Current Location.  





A new location appears in the Project pane, using the default name of Location.   The new location will appear in whatever part of the Project pane had the focus.  For example, if we had clicked on the Locations folder to move the focus there, the new location would have been created within the Locations folder.  


We can rename the location if we like.





We slow-double-click the new location to change the name to something more memorable.   We enter All France as the new name and press Enter.   It is wise to give locations a memorable name.

Go to a Location

We will now go to one of the saved locations.





To go to the Amiens Cathedral location we click on the Locations button and in the drop-down menu we choose Amiens Cathedral.  The drop-down menu lists all of the locations that exist in the project, including the new All France location we created earlier.





Whatever window has the focus will immediately pan and zoom to the location stored in the Amiens Cathedral location.  





We can double-click off the streets layer to see in the Bing satellite layer we have indeed panned and zoomed to the famous cathedral in Amiens, France.





 To go to the Chartres location we choose the Chartres Cathedral location in the drop-down menu.  





Instantly, the view pans and zooms to the famous cathedral in Chartres, which narrowly escaped destruction in WWII due to the heroism of one man.   We see the beloved cafe Le Serpente on the corner, just above the S in "Satellite" in the tabs in the illustration above.   For a street view of Le Serpente, see the Example: Connect to an OSM Vector Server topic.


We can see that this location, as with the prior one, also uses a scale of 1:3000.  

Go to a Location using the Context Menu

We can also go to a location by right-clicking it in the Project pane and choosing View in Active Window.





For example, if we want to go to the Reims Cathedral location we right-click onto Reims Cathedral and then we choose View in Active Window.





The view immediately pans to Reims.   We see the beautiful cathedral located in Reims, the epicenter of France's champagne industry, with many champagne caves and producers located underneath and within the downtown part of the city.  


In the lower left of the map window is a fine brasserie, Au Bureau, that serves outdoor lunches on the square in good weather.  Order champagne with your burger for the definitive, slightly overpriced, but worth-every-euro, cathedral viewing experience.  After lunch, grab a few bottles to take home from the Cave des Sacres, a shop with an extensive selection of champagnes, at surprisingly reasonable prices given the tourist-center location.


The Reims cathedral suffered extensive damage in the First World War when the massive German artillery bombardment that flattened Reims set it ablaze.  Eye witnesses describe how the burning roof melted the lead tiles covering the roof, sending streams of molten lead gushing from the mouths of stone gargoyles, truly a scene from the Inferno.   Almost all of the original stained glass windows were destroyed, very much unlike Chartres, which still retains most of the original stained glass.   Reims was spared further damage in the Second World War and over the last century has been restored.

Go to a View Shown in a Different Window

We take a moment to create a map called OSM Map, into which we drag the OpenStreetMaps Base image layer.



Suppose in our project we have a different window open, the OSM Map window seen above, which shows an OpenStreetMaps layer panned and zoomed to a view of Marseille, France.  We have undocked the window using Shift-click so it can be resized and positioned wherever we want on our Windows desktop.





With the focus on our Map window, we can pan and zoom that to the same location seen in the OSM Map window.   


 When another window is open, the drop-down menu for the Locations button will include a Windows entry at the top, which leads to sub-menu listing all opened windows.  We choose the OSM Map window.  





The view is instantly panned and zoomed to be the same as that seen in the OSM Map window.   It looks different because we are looking at a Bing satellite layer.





If we double-click the Bing streets layer back on, we can see it is the same view of Marseille, as shown by Bing streets.





 We can go back to the view of all of France by choosing the All France location in the drop-down menu.  


We close the OSM Map window.





The view immediately pans back to the stating view.     We now can double-click open the Amiens Cathedral location to see what it contains.



The location component is a simple text component that contains the information for the location in JSON format.  If we want to change the scale we can edit it just like any other text.   We can highlight it and change it.




For example, we can change the scale from 3000 to 10000.  Close the window.


 Important: After editing the locations component, close it for the edit to take effect.





 We again choose the Amiens Cathedral location in the drop-down menu, to see what happens now that we have modified the text inside the location to change the scale.





We can see the view now pans and zooms to a scale of 1:10,000.   In the view above we have double-clicked off the streets layer for a more dramatic, satellite view.

Manually Create a Location

Locations are just text.   We can manually enter text, or copy and paste it from other sources.


{ "Center": [ 4.63082, 43.67774 ], "Scale": 2000 }


Suppose a friend has sent us the above text, perhaps in an email message, as an interesting place to look at in a Bing satellite layer.   We would like to take a look at it in Bing, and to do that we will create a location using that text.


 To quickly create a new location that we can edit, with the focus on the map we click on the Locations button and in the drop-down menu we choose Save Current Location.  




We double-click the resulting location to open it.   



It contains text as seen above.   We do not care about the text as we will replace it.



We highlight the text.   Next, we Copy the text string our friend sent us, and we Paste it into the Location to replace the highlighted text.



The result is seen above.   We close the Location.





We will give the location a more memorable name, renaming it A sight to see.





 We can take a look at that location in the Bing satellite layer by choosing the A sight to see location in the drop-down menu.  





We see the location reveals the Roman amphitheater in Arles, France.   The satellite which snapped the overhead photograph of that region in France caught a bullfight in action in the ancient amphitheater, which is still used for performances and bullfights.  Anyone can copy and paste the location from this topic into Manifold, or into a project in Viewer to see it in a Bing satellite layer.


 Web servers constantly change their content.   As Bing updates satellite imagery served in Bing's satellite layers sooner or later the image tiles which show the bullfight will be updated.  Since it is unlikely the satellite will pass overhead exactly when a bullfight is being held in the ancient amphitheater, sooner or later the satellite imagery will just show an empty amphitheater.


It is easy to create Locations from almost any source.  All we need are decimal latitude and longitude numbers for the Center plus a number for the Scale we desire, and we can write text for a Location.  For example, it is easy to write add-ins that can import saved Google Earth locations from a KML file, or from a table.


Migration from Release 8 - Opening .map  files created by Release 8 migrates component views into locations. The created locations are put into the same folder as the producing component.



Saving Chartres Cathedral - Chartres Cathedral, the Cathédrale Notre-Dame de Chartres, is well known for having almost all of the original, medieval, stained glass still in place, a miraculous survival over many centuries of warfare in France, and a further miracle given an order had gone out to destroy the entire cathedral during the Second World War.



During the Battle of Chartres on 16 August 1944, American forces advancing towards Chartres came under heavy artillery fire from German forces that held Chartres.  In the belief that German spotters directing the artillery fire were stationed in the bell towers of Chartres Cathedral, an excellent vantage point that commanded the terrain surrounding Chartres, the order went out from the headquarters of the American Army's XX Corps to annihilate Chartres Cathedral.



Colonel Welborn Griffith, an operations officer with XX Corps, convinced the commanding officers to hold off on destroying Chartres Cathedral until he could race behind enemy lines to determine if German forces were using the Cathedral as an observation point.  


Accompanied by his driver, whose name history regrettably does not record, Colonel Griffith evaded German forces holding Chartres and made his way to the cathedral, where he climbed the towers alone and verified no German forces were present.  Colonel Griffith reported his findings and succeeded in rescinding the order to destroy Chartres Cathedral.   On his way back to headquarters, in the small town of Lèves, near Chartres, after joining up with a small American detachment Colonel Griffith encountered German troops and was killed in action while leading an attack. He was posthumously decorated with the Silver Star, Distinguished Service Cross, and the French Croix de Guerre.   A small plaque with American and French flags, erected by local people to honor Colonel Griffith, marks the spot in Lèves where he fell, giving his life on a mission to save the great cathedral.



Colonel Welborn Griffith (1901 - 1944)  


For an example topic that uses footprints of buildings around Chartres Cathedral, and includes a nice view of Le Café Serpente, see the Example: Connect to an OSM Vector Server topic.


See Also

Getting Started


User Interface


















Layer Opacity


Project Pane


Example: Create a Table from Locations - Create a table that contains, as records, all of the Locations components in a project.  Each record contains the Name, Latitude, Longitude, and Scale of a location.  We use simple, point-and-click operations using the Select and Transform panes.


Example: VBScript to Create Locations from a Table - Use VBScript to take a table where each record has a name, scale, latitude and longitude and for each record create a Location component in the project.


Example: Connect to an OSM Vector Server - We connect to an OSM Server that provides a vector layer containing points and lines in the OpenStreetMap database.  We then show how to scrape (copy) data from the OpenStreetMap server into local storage.  We extract building footprints from the local copy.