File: xyz.rst

package info (click to toggle)
osgearth 2.7.0%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 49,960 kB
  • ctags: 18,411
  • sloc: cpp: 253,210; ansic: 43,140; xml: 1,637; objc: 405; makefile: 210; python: 29; sh: 20
file content (37 lines) | stat: -rw-r--r-- 1,371 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
XYZ
===
The XYZ plugin is useful for reading web map tile repositories with a
standard X/Y/LOD setup but that don't explicitly report any metadata.
Many of the popular web mapping services (like MapQuest_) fall into 
this category. You need to provide osgEarth with a ``profile`` when
using this driver.

Example usage::

    <image name="mapquest_open_aerial" driver="xyz">
        <url>http://oatile[1234].mqcdn.com/tiles/1.0.0/sat/{z}/{x}/{y}.jpg</url>
        <profile>spherical-mercator</profile>
    </image>

Creating the URL template:

    The square brackets [] indicate that osgEarth should "cycle through" the characters
    within, resulting in round-robin server requests. Some services require this.
    
    The curly braces {} are templates into which osgEarth will insert the proper
    ``x``, ``y``, and ``z`` values for the tile it's requesting.
    
Properties:

    :url:            Location of the tile repository (URL template -- see above)
    :profile:        Spatial profile of the repository
    :invert_y:       Set to true to invert the Y axis for tile indexing
    :format:         If the format is not part of the URL itself, you can specify it here.
    
Also see:

    ``mapquest_open_aerial.earth`` and ``openstreetmap.earth`` samples
    in the repo ``tests`` folder.


.. _MapQuest: http://developer.mapquest.com/web/products/open/map