## ChamplainNetworkBboxTileSource ChamplainNetworkBboxTileSource — A map source that loads tile data from an OpenStreetMap API server |

## Synopsis

    struct              ChamplainNetworkBboxTileSource;
    ChamplainNetworkBboxTileSource * champlain_network_bbox_tile_source_new_full
                                                            (const gchar *id,
                                                             const gchar *name,
                                                             const gchar *license,
                                                             const gchar *license_uri,
                                                             guint min_zoom,
                                                             guint max_zoom,
                                                             guint tile_size,
                                                             ChamplainMapProjection projection,
                                                             ChamplainRenderer *renderer);
    void                champlain_network_bbox_tile_source_load_map_data
                                                            (ChamplainNetworkBboxTileSource *map_data_source,
                                                             ChamplainBoundingBox *bbox);
    const gchar *       champlain_network_bbox_tile_source_get_api_uri
                                                            (ChamplainNetworkBboxTileSource *map_data_source);
    void                champlain_network_bbox_tile_source_set_api_uri
                                                            (ChamplainNetworkBboxTileSource *map_data_source,
                                                             const gchar *api_uri);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----ChamplainMapSource
                   +----ChamplainTileSource
                         +----ChamplainNetworkBboxTileSource

## Properties

      "api-uri"                  gchar*                : Read / Write
      "proxy-uri"                gchar*                : Read / Write
      "state"                    ChamplainState        : Read / Write

## Description

This map source source downloads the map data from an OpenStreetMap API server. It supports protocol version 0.5 and 0.6.

http://wiki.openstreetmap.org/wiki/API

## Details

### struct ChamplainNetworkBboxTileSource

    struct ChamplainNetworkBboxTileSource;

The ChamplainNetworkBboxTileSource structure contains only private data and should be accessed using the provided API

Since 0.8

### champlain_network_bbox_tile_source_new_full ()

    ChamplainNetworkBboxTileSource * champlain_network_bbox_tile_source_new_full
                                                            (const gchar *id,
                                                             const gchar *name,
                                                             const gchar *license,
                                                             const gchar *license_uri,
                                                             guint min_zoom,
                                                             guint max_zoom,
                                                             guint tile_size,
                                                             ChamplainMapProjection projection,
                                                             ChamplainRenderer *renderer);

Constructor of ChamplainNetworkBboxTileSource.

`id` : | the map source's id
`name` : | the map source's name
`license` : | the map source's license
`license_uri` : | the map source's license URI
`min_zoom` : | the map source's minimum zoom level
`max_zoom` : | the map source's maximum zoom level
`tile_size` : | the map source's tile size (in pixels)
`projection` : | the map source's projection
`renderer` : | the ChamplainRenderer used to render tiles
Returns : | a constructed ChamplainNetworkBboxTileSource object

Since 0.8

### champlain_network_bbox_tile_source_load_map_data ()

    void                champlain_network_bbox_tile_source_load_map_data
                                                            (ChamplainNetworkBboxTileSource *map_data_source,
                                                             ChamplainBoundingBox *bbox);

Asynchronously loads map data within a bounding box from the server. The box must not exceed an edge size of 0.25 degree. There are also limitations on the maximum number of nodes that can be requested.

For details, see: http://api.openstreetmap.org/api/capabilities

`map_data_source` : | a ChamplainNetworkBboxTileSource
`bbox` : | bounding box of the requested area

Since 0.10

### champlain_network_bbox_tile_source_get_api_uri ()

    const gchar *       champlain_network_bbox_tile_source_get_api_uri
                                                            (ChamplainNetworkBboxTileSource *map_data_source);

Gets the URI of the API server.

`map_data_source` : | a ChamplainNetworkBboxTileSource
Returns : | the URI of the API server.

Since 0.8

### champlain_network_bbox_tile_source_set_api_uri ()

    void                champlain_network_bbox_tile_source_set_api_uri
                                                            (ChamplainNetworkBboxTileSource *map_data_source,
                                                             const gchar *api_uri);

Sets the URI of the API server.

`map_data_source` : | a ChamplainNetworkBboxTileSource
`api_uri` : | an URI of an API server

Since 0.8

## Property Details

### The `"api-uri"` property

      "api-uri"                  gchar*                : Read / Write

The URI of an OpenStreetMap API server

Default value: "http://www.informationfreeway.org/api/0.6"

Since 0.8

### The `"proxy-uri"` property

      "proxy-uri"                gchar*                : Read / Write

Used to override the default proxy for accessing the network.

Default value: ""

Since 0.8

### The `"state"` property

      "state"                    ChamplainState        : Read / Write

The map source's state. Useful to know if the data source is loading or not.

Default value: CHAMPLAIN_STATE_NONE

Since 0.8