Changes between Version 1 and Version 2 of MapGuideRfc4


Ignore:
Timestamp:
02/27/07 18:25:45 (18 years ago)
Author:
waltweltonlair
Comment:

Just formatting fixes...

Legend:

Unmodified
Added
Removed
Modified

  • MapGuideRfc4

    v1 v2  
    2323== Motivation ==
    2424
    25 By integrating MapGuide with Google Earth, we provide a compelling way for users to visualize their data in relation to the planet as a whole. In addition to satellite imagery, Google provides a large amount of useful content, such as road networks, points of interest, voting districts etc. By serving up MapGuide data via KML (and its compressed form, KMZ) we allow users to incorporate their specific data set with Google's.
     25By integrating !MapGuide with Google Earth, we provide a compelling way for users to visualize their data in relation to the planet as a whole. In addition to satellite imagery, Google provides a large amount of useful content, such as road networks, points of interest, voting districts etc. By serving up !MapGuide data via KML (and its compressed form, KMZ) we allow users to incorporate their specific data set with Google's.
    2626
    27 So, for example, if a MapGuide data set contained information about underground pipes and sewers, this information could be overlaid on a satellite image showing individual streets and houses. This would greatly facilitate the process of estimating exactly which homes and streets would be affected by any maintenance required on those pipes.
     27So, for example, if a !MapGuide data set contained information about underground pipes and sewers, this information could be overlaid on a satellite image showing individual streets and houses. This would greatly facilitate the process of estimating exactly which homes and streets would be affected by any maintenance required on those pipes.
    2828
    2929== Proposed Solution ==
    3030
    31 A new service will be added to MapGuide that supports three request types - GetMapKml, GetLayerKml and GetFeaturesKml.
     31A new service will be added to !MapGuide that supports three request types - !GetMapKml, !GetLayerKml and !GetFeaturesKml.
    3232
    33 '''GetMapKml''' is designed to be the single point of user-initiated contact with the server. It takes the following parameters:
     33'''!GetMapKml''' is designed to be the single point of user-initiated contact with the server. It takes the following parameters:
    3434
    35 OPERATION = GetMapKml
     35OPERATION = !GetMapKml
    3636
    3737VERSION = 1
    … …  
    4343FORMAT = KML, KMZ or XML
    4444
    45 This request can be made from a URL link in a web page. It generates a KML document representing the requested map definition. This document contains one NetworkLink element for each layer in the map. Google Earth uses these elements to make GetLayerKml requests back to MapGuide to retrieve further dynamic data for each layer.
     45This request can be made from a URL link in a web page. It generates a KML document representing the requested map definition. This document contains one !NetworkLink element for each layer in the map. Google Earth uses these elements to make !GetLayerKml requests back to !MapGuide to retrieve further dynamic data for each layer.
    4646
    4747If the format is KMZ, the KML document is compressed inside a zip file before being returned in the response. The mime types returned for KML and KMZ responses cause Google Earth to start up automatically and display the content of the document. If the requested format is XML, the mime type returned is text/xml, and the text of the KML document is typically displayed directly in the browser window.
    4848
    49 '''GetLayerKml''' is designed to be called only by Google Earth. Its format may change in order to accomodate future enhancements to our KML support. It is therefore not recommended to call this operation directly. It supports the following parameters:
     49'''!GetLayerKml''' is designed to be called only by Google Earth. Its format may change in order to accomodate future enhancements to our KML support. It is therefore not recommended to call this operation directly. It supports the following parameters:
    5050
    51 OPERATION = GetLayerKml
     51OPERATION = !GetLayerKml
    5252
    5353VERSION = 1
    … …  
    6565HEIGHT = the current map height in pixels
    6666
    67 The KML generated by the GetMapKml request populates the first 5 of these parameters, and the link is formatted in such a way that Google Earth provides the BBOX, WIDTH and HEIGHT parameters corresponding to its current view.
     67The KML generated by the !GetMapKml request populates the first 5 of these parameters, and the link is formatted in such a way that Google Earth provides the BBOX, WIDTH and HEIGHT parameters corresponding to its current view.
    6868
    69 GetLayerKml returns a KML document containing a <NetworkLink> element corresponding to each scale range supported by the layer that is currently visible. <Region> elements are used to instruct Google Earth only to request data via these links when the current scale falls within the scale range and when the current map extent intersects the extent of the data.
     69!GetLayerKml returns a KML document containing a <!NetworkLink> element corresponding to each scale range supported by the layer that is currently visible. <Region> elements are used to instruct Google Earth only to request data via these links when the current scale falls within the scale range and when the current map extent intersects the extent of the data.
    7070
    71 '''GetFeaturesKml''' is designed to be called only by Google Earth. Its format may change in order to accomodate future enhancements to our KML support. It is therefore not recommended to call this operation directly. It supports the following parameters:
     71'''!GetFeaturesKml''' is designed to be called only by Google Earth. Its format may change in order to accomodate future enhancements to our KML support. It is therefore not recommended to call this operation directly. It supports the following parameters:
    7272
    73 OPERATION = GetFeaturesKml
     73OPERATION = !GetFeaturesKml
    7474
    7575VERSION = 1
    … …  
    8787HEIGHT = the current map height in pixels
    8888
    89 GetFeaturesKml returns the actual content to be rendered on the map. For feature layers, a KML document is returned that contains the features represented in vector format, plus style information such as the color, line width etc. For raster layers, the raster image is returned in PNG format. Drawing layers (from DWF files) will not be supported (yet).
     89!GetFeaturesKml returns the actual content to be rendered on the map. For feature layers, a KML document is returned that contains the features represented in vector format, plus style information such as the color, line width etc. For raster layers, the raster image is returned in PNG format. Drawing layers (from DWF files) will not be supported (yet).
    9090
    9191== Implications ==