datasets.load_tile_map¶
pygmt.datasets.load_tile_map(region, zoom='auto', source=None,
lonlat=True, wait=0, max_retries=2)
Utilité :¶
Chargez une carte de tuiles raster géoréférencées à partir de fournisseurs de tuiles XYZ.
Les tuiles qui composent la carte sont fusionnées et géoréférencées en une xarray.DataArrayimage à 3 bandes (RVB). Notez que l’image renvoyée est dans un système de référence de coordonnées Spherical Mercator (EPSG:3857).
Paramètres :¶
region ( list ) – La boîte englobante de la carte sous la forme d’une liste [ xmin , xmax , ymin , ymax ]. Ces coordonnées doivent être en longitude/latitude si lonlat=Trueou Spherical Mercator (EPSG:3857) si lonlat=False.
zomme ( int ou str ) –
Facultatif. Niveau de détail. Des niveaux plus élevés (par exemple 22) signifient un niveau de zoom plus proche de la surface de la Terre, avec plus de tuiles couvrant une zone géographique plus petite et donc plus de détails. Des niveaux inférieurs (par exemple 0) signifient un niveau de zoom plus éloigné de la surface de la Terre, avec moins de tuiles couvrant une zone géographique plus grande et donc moins de détails [la valeur par défaut consiste à « auto »déterminer automatiquement le niveau de zoom en fonction de l’étendue de la zone de délimitation].
Remarque : Le niveau de zoom maximal possible peut être inférieur à 22, et dépend de ce qui est pris en charge par la source du fournisseur de tuiles Web choisie.
source ( xyzservices.TileProvider ou str ) – Facultatif. La source de tuiles : fournisseur de tuiles Web ou chemin d’accès à un fichier local. Fournir soit :
Un fournisseur de vignettes Web sous la forme d’un xyzservices.TileProviderobjet. Voir les fournisseurs contextuels pour une liste des fournisseurs de tuiles [la valeur par défaut est xyzservices.providers.Stamen.Terrain, c’est-à-dire les tuiles Web Stamen Terrain].
Un fournisseur de vignettes Web sous la forme d’une URL. Les espaces réservés pour XYZ dans l’URL doivent être {x}, {y}, {z}, respectivement. Par exemple https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png.
Un chemin de fichier local. Le fichier est lu avec rasterio et toutes les bandes sont chargées dans le fond de carte. Voir Travailler avec des fichiers locaux .
IMPORTANT : les tuiles sont supposées être dans la projection sphérique de Mercator (EPSG : 3857).
lonlat ( booléen ) – Facultatif. Si False, les coordonnées dans regionsont supposées être Mercator sphérique par opposition à la longitude/latitude [la valeur par défaut est True].
wait ( int ) – Facultatif. Si l’API de mosaïque est limitée en débit, le nombre de secondes à attendre entre une requête ayant échoué et la prochaine tentative [la valeur par défaut est 0].
max_retries ( int ) – Facultatif. Le nombre total de requêtes rejetées autorisées avant d’arrêter contextuellement d’essayer de récupérer plus de vignettes à partir d’une API à débit limité [la valeur par défaut est 2].
Retour¶
raster ( xarray.DataArray ) – Tableau de données 3D géoréférencées de valeurs RVB.
Augmente¶
ImportError - Si contextily n’est pas installé ou ne peut pas être importé. Suivez les instructions d’installation pour contextily , (par exemple via) avant d’utiliser cette fonction. pip install contextily
Exemples¶
import contextily
from pygmt.datasets import load_tile_map
raster = load_tile_map(
region=[-180.0, 180.0, -90.0, 0.0], # West, East, South, North
zoom=1, # less detailed zoom level
source=contextily.providers.Stamen.TerrainBackground,
lonlat=True, # bounding box coordinates are longitude/latitude
)
raster.sizes
Frozen({'band': 3, 'y': 256, 'x': 512})
raster.coords
Coordinates:
* band (band) uint8 0 1 2
* y (y) float64 -7.081e-10 -7.858e+04 ... -1.996e+07 ...
* x (x) float64 -2.004e+07 -1.996e+07 ... 1.996e+07 2.004e+07