Class BingSource
Defined in File bing_source.h
Inheritance Relationships
Base Type
public tile_map::TileSource(Class TileSource)
Class Documentation
-
class BingSource : public tile_map::TileSource
Public Functions
-
explicit BingSource(const QString &name)
Initializes a Bing map source with a given name.
Note that currently, only a single, hard-coded Bing map source is supported. There’s only one Bing Maps, after all. In the future, though, it would probably make sense to extend its functionality to allow pulling different tile sets from Bing.
- Parameters:
name – The name the source will appear as in the combo box.
-
virtual size_t GenerateTileHash(int32_t level, int64_t x, int64_t y) override
Generates a unique hash that identifies the tile as the given coordinates.
Note that Bing Maps tiles could potentially be pulled from one of many different servers, depending on the subdomain list given to us after we authenticate with our API Key. That means the exact URL to any given tile should not be used as part of the hash, because there are many valid URLs for a tile.
- Parameters:
level – The zoom level
x – The X coordinate
y – The Y coordinate
- Returns:
A hash that uniquely identifies this tile
-
virtual QString GenerateTileUrl(int32_t level, int64_t x, int64_t y) override
Generates a URL that will retrieve a tile for the given coordinates.
Since Bing can give us a list of subdomains to pull tiles from, the exact subdomain for a tile is chosen at random every time this function is called. That means you are not guaranteed to get the same URL for a tile every time you call this function.
- Parameters:
level – The zoom level
x – The X coordinate
y – The Y coordinate
- Returns:
A URL that points to this tile
-
virtual QString GetType() const override
Returns a string identifying the type of map source (“wmts”, “bing”, etc.)
- Returns:
-
QString GetApiKey() const
-
void SetApiKey(const QString &api_key)
Bing requires an API key in order to access its tiles. The key provided will determine the URL we use to retrieve map tiles, so setting the API key will also cause this object to make a network request to the Bing Map server to get the appropriate URL.
More information about getting an API key: https://msdn.microsoft.com/en-us/library/ff428642.aspx
- Parameters:
api_key – A valid Bing Maps key
Public Static Attributes
-
static const QString BING_TYPE
Protected Functions
-
QString GenerateQuadKey(int32_t level, int64_t x, int64_t y) const
Bing Maps identifies tiles using a quadkey that is generated from the zoom level and x and y coordinates. Details on how the quadkey is generated can be found here: https://msdn.microsoft.com/en-us/library/bb259689.aspx
- Parameters:
level – The zoom level
x – The X coordinate
y – The Y coordinate
- Returns:
The quadkey that represents the tile at the requested location
Protected Attributes
-
QString api_key_
-
boost::hash<std::string> hash_
-
QNetworkAccessManager network_manager_
-
boost::random::mt19937 rng_
-
std::vector<QString> subdomains_
-
QString tile_url_
Protected Slots
-
void ReplyFinished(QNetworkReply *reply)
-
explicit BingSource(const QString &name)