Changes between Version 3 and Version 4 of MapGuideCommercialOverlays

Timestamp:

05/01/09 07:43:29 (16 years ago)

Author:

zjames

Comment:

added VE and Yahoo information

MapGuideCommercialOverlays

@@ -1 +1 @@
 = Using MapGuide Overlays with Commercial Map Service Layers =
-
 Commercial tiled map layers can be used as base layers within MapGuide flexible layouts, provided you make some modifications to your application and map projection.
 
@@ -18 +17 @@
 http://code.google.com/apis/maps/signup.html
 
-After submitting the request, you should get a sample script tag that looks like 
+After submitting the request, you should get a sample script tag like this:
 {{{
 <script src="http://maps.google.com/maps?file=api&amp;v=2&amp;sensor=false&amp;key=<your key here>" type="text/javascript"></script>
@@ -24 +23 @@
 
 Note that the sensor argument has been set to false.
+
+Microsoft's Virtual Earth service can be used by including this script tag:
+{{{
+<script src='http://dev.virtualearth.net/mapcontrol/mapcontrol.ashx?v=6.1'></script>
+}}}
+
+Finally, Yahoo's service requires you to obtain a key from:
+
+http://developer.yahoo.com/maps
+
+You should get a script tag that looks like
+{{{
+<script src="http://api.maps.yahoo.com/ajaxymap?v=3.0&appid=<your key here>"></script>
+}}}
 
 If you haven't already done so, use the !MapGuide [http://localhost:8008/mapguide/mapadmin/login.php MapAdmin] page to load the Sheboygan sample data which will be used as an example overlay.
@@ -43 +56 @@
 = Step 2: Update the projection information in the !MapDefinition =
 
-Since the Google Map system uses a modified Mercator projection, any overlaid !MapGuide data needs to be transformed into the same map projection. !MapGuide can reproject vector data on the fly, meaning the original sample set can be used provided that we modify the !MapDefinition to use the Mercator output projection.
+Since the Google, Microsoft and Yahoo mapping systems all use the same modified Mercator projection, any overlaid !MapGuide data needs to be transformed into that coordinate system. !MapGuide can reproject vector data on the fly, meaning the original sample set can be used provided that we modify the !MapDefinition to use the Mercator output projection.
 
  * Using !MapGuide Maestro, connect to the !MapGuide server and make a duplicate of the /Samples/Sheboygan/Maps/Sheboygan  !MapDefinition resource using the Edit menu copy and paste commands. Rename the copy to Sheboygan-m.
@@ -76 +89 @@
 }}}
 
- * If you don't like the default Google map type, you can add an <Options> tag to the Google layer and change it:
+ * If you don't like the default Google map type, you can add an <Options> tag to the Google layer to change it:
 
 {{{
@@ -114 +127 @@
 }}}
 
-Note that the Google layer must be the base layer so any overlays must have the isBaseLayer: false option set.
+'' Note that the Google layer must be the base layer so any overlays must have the isBaseLayer: false option set. ''
 
  * Load the template in a browser: http://localhost:8008/mapguide/fusion/templates/mapguide/standard/
+
+To use the Microsoft Virtual Earth or Yahoo mapping services as base maps, remove the google <Map> block from your !ApplicationDefinition and replace it with
+
+{{{
+      <Map xsi:type="WMSLayerType">
+        <Type>VirtualEarth</Type>
+        <Extension>
+          <ResourceId>ve</ResourceId>
+        </Extension>
+      </Map>
+}}}
+for Virtual Earth or
+{{{
+      <Map xsi:type="WMSLayerType">
+        <Type>Yahoo</Type>
+        <Extension>
+          <ResourceId>yahoo</ResourceId>
+        </Extension>
+      </Map>
+}}}
+for Yahoo.
+
+''Support for these layer types is a new addition to Fusion 2.0 so you may encounter compatibility issues. Please help the project by reporting them to the fusion-dev mailing list or filing a bug in the fusion trac instance.''