ChamplainNetworkBboxTileSource

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

Synopsis

                    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,
                                                         gdouble bound_left,
                                                         gdouble bound_bottom,
                                                         gdouble bound_right,
                                                         gdouble bound_top);
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

ChamplainNetworkBboxTileSource

typedef struct _ChamplainNetworkBboxTileSource ChamplainNetworkBboxTileSource;


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,
                                                         gdouble bound_left,
                                                         gdouble bound_bottom,
                                                         gdouble bound_right,
                                                         gdouble bound_top);

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

bound_left :

the left bound in degree

bound_bottom :

the lower bound in degree

bound_right :

the right bound in degree

bound_top :

the upper bound in degree

Since 0.8


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

The proxy URI to use to access 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