Changeset 11960

Show
Ignore:
Timestamp:
08/25/07 18:23:32 (1 year ago)
Author:
warmerdam
Message:

improved documentation from Chris (#1765)

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/gdal/frmts/wms/frmt_wms.html

    r11955 r11960  
    11<html> 
    22<head> 
    3 <title>WMS -- OGC Web Map Service</title> 
     3<title>WMS -- Web Map Services</title> 
    44</head> 
    55 
    66<body bgcolor="#ffffff"> 
    77 
    8 <h1>WMS -- OGC Web Map Service</h1> 
     8<h1>WMS -- Web Map Services</h1> 
    99 
     10<p> 
     11  Accessing several different types of web image services is possible 
     12  using the WMS format in GDAL. Services are accessed by creating a 
     13  local service description XML file -- there are examples below for  
     14  each of the supported image services. 
     15</p> 
     16 
     17<h2>OGC Web Map Service</h2> 
     18 
     19<p> 
    1020Accessing a WMS server is accomplished by creating a local service description 
    1121xml file looking something like the following. It is important that there be no 
    1222spaces or other content before the <tt>&lt;GDAL_WMS&gt;</tt> element.<p> 
     23</p> 
    1324 
    1425<pre> 
    …… 
    3546</pre> 
    3647 
     48<p> 
     49 It is possible to configure a WMS Service conforming to a WMS-C cache by 
     50 specifying a number of overviews and specifying the 'block size' as the  
     51 tile size of the cache. The following example is a sample set up for  
     52 a 19-level "Global Profile" WMS-C cache: 
     53</p>  
     54<pre>  
     55&lt;GDAL_WMS&gt; 
     56    &lt;Service name="WMS"&gt; 
     57        &lt;Version&gt;1&lt;/Version&gt; 
     58        &lt;ServerUrl&gt;http://labs.metacarta.com/wms-c/Basic.py?&lt;/ServerUrl&gt; 
     59        &lt;Layers&gt;basic&lt;/Layers&gt; 
     60    &lt;/Service&gt; 
     61    &lt;DataWindow&gt; 
     62        &lt;UpperLeftX&gt;-180.0&lt;/UpperLeftX&gt; 
     63        &lt;UpperLeftY&gt;90.0&lt;/UpperLeftY&gt; 
     64        &lt;LowerRightX&gt;180.0&lt;/LowerRightX&gt; 
     65        &lt;LowerRightY&gt;-90.0&lt;/LowerRightY&gt; 
     66        &lt;SizeX&gt;268435456&lt;/SizeX&gt; 
     67        &lt;SizeY&gt;134217728&lt;/SizeY&gt; 
     68        &lt;TileLevel&gt;19&lt;/TileLevel&gt; 
     69    &lt;/DataWindow&gt; 
     70    &lt;Projection&gt;EPSG:4326&lt;/Projection&gt; 
     71    &lt;OverviewCount&gt;19&lt;/OverviewCount&gt; 
     72    &lt;BlockSizeX&gt;256&lt;/BlockSizeX&gt; 
     73    &lt;BlockSizeY&gt;256&lt;/BlockSizeY&gt; 
     74    &lt;BandsCount&gt;3&lt;/BandsCount&gt; 
     75&lt;/GDAL_WMS&gt; 
     76</pre> 
     77 
     78<h2>TileService</h2> 
     79<p> 
     80  TileService is a specific type of request format used by WorldWind. 
     81  It is described as being "a bunch of PHP scripts used to serve image data to  
     82  World Wind, GDAL and some other software."  
     83</p> 
     84<p>Example TileService Configuration:</p> 
     85<pre> 
     86&lt;GDAL_WMS&gt; 
     87    &lt;Service name="TileService"&gt; 
     88        &lt;Version&gt;1&lt;/Version&gt; 
     89        &lt;ServerUrl&gt;http://s0.tileservice.worldwindcentral.com/getTile?&lt;/ServerUrl&gt; 
     90        &lt;Dataset&gt;za.johannesburg_2006_20cm&lt;/Dataset&gt; 
     91    &lt;/Service&gt; 
     92    &lt;DataWindow&gt; 
     93        &lt;UpperLeftX&gt;-180.0&lt;/UpperLeftX&gt; 
     94        &lt;UpperLeftY&gt;90.0&lt;/UpperLeftY&gt; 
     95        &lt;LowerRightX&gt;180.0&lt;/LowerRightX&gt; 
     96        &lt;LowerRightY&gt;-90.0&lt;/LowerRightY&gt; 
     97        &lt;SizeX&gt;268435456&lt;/SizeX&gt; 
     98        &lt;SizeY&gt;134217728&lt;/SizeY&gt; 
     99        &lt;TileLevel&gt;19&lt;/TileLevel&gt; 
     100    &lt;/DataWindow&gt; 
     101    &lt;Projection&gt;EPSG:4326&lt;/Projection&gt; 
     102    &lt;OverviewCount&gt;16&lt;/OverviewCount&gt; 
     103    &lt;BlockSizeX&gt;512&lt;/BlockSizeX&gt; 
     104    &lt;BlockSizeY&gt;512&lt;/BlockSizeY&gt; 
     105    &lt;BandsCount&gt;3&lt;/BandsCount&gt; 
     106&lt;/GDAL_WMS&gt; 
     107</pre> 
    37108<ul> 
    38109<li> <b> </b>:  
    …… 
    42113 
    43114<ul> 
    44 <li> <a href="http://www.opengeospatial.org/standards/wms">OGC WMS Standards</a> 
     115<li> <a href="http://www.opengeospatial.org/standards/wms">OGC WMS Standards</a></li> 
     116<li><a href="http://wiki.osgeo.org/index.php/WMS_Tiling_Client_Recommendation">WMS Tiling Client Recommendation</a></li> 
     117<li><a href="http://www.worldwindcentral.com/wiki/TileService">TileService</a></li> 
    45118</ul> 
    46119