Figure.tilemap¶
Ici vous aurez des explications sur la commande et ses différents paramètres.
Figure.tilemap(region, zoom='auto', source=None, lonlat=True,
wait=0, max_retries=2, \*, frame=None, dpi=None, shading=None,
projection=None, monochrome=None, no_clip=None, nan_transparent=
None, verbose=None, panel=None, perspective=None, transparency=None,
\**kwargs)
Utilité :¶
Trace une carte de tuiles XYZ.
Cette méthode charge des tuiles de carte XYZ à partir d’un serveur de tuiles ou d’un fichier local à l’aide de pygmt.datasets.load_tile_map et les trace sous forme de fond de carte ou de superposition à l’aide de pygmt.Figure.grdimage.
Remarque : Par défaut, les tuiles de carte Web standard servies dans un format cartésien Mercator sphérique (EPSG:3857) seront reprojetées dans un système de coordonnées géographiques de référence (OGC:WGS84) et tracées avec des limites de longitude/latitude lorsque lonlat=True. Si la reprojection n’est pas souhaitée, veuillez définir lonlat=False et fournir des coordonnées Mercator sphériques (EPSG:3857) au paramètre de région.
Paramètres :¶
région (liste) - La zone englobante de la carte sous la forme d’une liste [xmin, xmax, ymin, ymax]. Ces coordonnées doivent être en longitude/latitude si lonlat=True, ou en Mercator sphérique (EPSG:3857) si lonlat=False.
zoom (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 est « auto » pour déterminer automatiquement le niveau de zoom en fonction de l’étendue de la région de la zone englobante].
Note : Le niveau de zoom maximal possible peut être inférieur à 22 et dépend de ce qui est pris en charge par la source de fournisseur de tuiles Web choisie.
source (xyzservices.TileProvider ou str) - Facultatif. La source de tuiles : fournisseur de tuiles Web ou chemin vers un fichier local. Fournissez l’une des options suivantes :
Un fournisseur de tuiles Web sous la forme d’un objet xyzservices.TileProvider. Voir les fournisseurs de contextily pour une liste de fournisseurs de tuiles [La valeur par défaut est xyzservices.providers.Stamen.Terrain, c’est-à-dire les tuiles Web Stamen Terrain].
Un fournisseur de tuiles Web sous la forme d’une URL. Les espaces réservés pour les coordonnées XYZ dans l’URL doivent être respectivement {x}, {y}, {z}. 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 la section Travailler avec des fichiers locaux.
IMPORTANT : Les tuiles sont supposées être dans la projection Mercator sphérique (EPSG:3857).
lonlat (bool) - Facultatif. Si False, les coordonnées de la région sont supposées être en Mercator sphérique plutôt qu’en longitude/latitude [La valeur par défaut est True].
wait (int) - Facultatif. Si l’API de tuiles est limitée en termes de taux d’utilisation, le nombre de secondes à attendre entre une requête échouée et la prochaine tentative [La valeur par défaut est 0].
max_retries (int) - Facultatif. Nombre total de demandes rejetées autorisées avant que contextily cesse d’essayer de récupérer plus de tuiles à partir d’une API limitée en termes de taux d’utilisation [La valeur par défaut est 2].
kwargs (dict) - Arguments supplémentaires à transmettre à pygmt.Figure.grdimage.