Eh$SrSSKrSSKrSSKJr SSKrSSK J r J r J r J r Jr SSKJrJrJr SSKJr SSKJr \R.R1S5rS \3r"S S \5rS S jrg)z-Tools for generating maps from a text search.N)howmany bounds2raster bounds2img_sm2ll_calculate_zoom) INTERPOLATIONZOOMadd_attribution) providers) TileProvideri@Bcontextily_user_cx\rSrSrSrSSSS\R R\S94Sjr Sr S\ \ S4Sjr SrS rg) Placea.Geocode a place by name and get its map. This allows you to search for a name (e.g., city, street, country) and grab map and location data from the internet. Parameters ---------- search : string The location to be searched. zoom : int or None [Optional. Default: None] The level of detail to include in the map. Higher levels mean more tiles and thus longer download time. If None, the zoom level will be automatically determined. path : str or None [Optional. Default: None] Path to a raster file that will be created after getting the place map. If None, no raster file will be downloaded. zoom_adjust : int or None [Optional. Default: None] The amount to adjust a chosen zoom level if it is chosen automatically. source : xyzservices.providers object or str [Optional. Default: OpenStreetMap Humanitarian web tiles] The tile source: web tile provider or path to local file. The web tile provider can be in the form of a :class:`xyzservices.TileProvider` object or a URL. The placeholders for the XYZ in the URL need to be `{x}`, `{y}`, `{z}`, respectively. For local file paths, the file is read with `rasterio` and all bands are loaded into the basemap. IMPORTANT: tiles are assumed to be in the Spherical Mercator projection (EPSG:3857), unless the `crs` keyword is specified. geocoder : geopy.geocoders [Optional. Default: geopy.geocoders.Nominatim()] Geocoder method to process `search` Attributes ---------- geocode : geopy object The result of calling ``geopy.geocoders.Nominatim`` with ``search`` as input. s : float The southern bbox edge. n : float The northern bbox edge. e : float The eastern bbox edge. w : float The western bbox edge. im : ndarray The image corresponding to the map of ``search``. bbox : list The bounding box of the returned image, expressed in lon/lat, with the following order: [minX, minY, maxX, maxY] bbox_map : tuple The bounding box of the returned image, expressed in Web Mercator, with the following order: [minX, minY, maxX, maxY] N) user_agentc jX0lUc[RRnXPlX@lUR U5n[R"URSVs/sHn[U5PM sn5n SURR5;aURSn O0SURR5;aURSn OUn Xl Xl U uUlUlUlUlUR URUR"UR/UlUR&UlUR(UlXplUc6[+UR URUR"UR5OUUl[/UR,5UlUR bU=R,U- sl[1UR URUR"URUR,SS9UlUR55 gs snf)N boundingbox display_nameaddressF)verbose)pathr OpenStreetMapHOTsource zoom_adjustgeocodenparrayrawfloatkeysplacesearchsnwebboxlatitude longituderzoomintrn_tiles_get_map) selfr$r,rrrgeocoderrespiir)r#s cC:\Users\julio\OneDrive\Documentos\Trabajo\Ideas Frescas\venv\Lib\site-packages\contextily/place.py__init__Place.__init__Is >,,00F &'xxTXXm-DE-Drr-DEF TXX]]_ ,HH^,E $((--/ )HHY'EE  )-&VVTVVTVVTVV4    @D|ODFFDFFDFFDFF ;QU  N    ' II $ItvvtvvtvvtvvtyyRWX  5Fs"H0c SS0nURbURUS'[UR[5(aQ[ UR UR URURUR4SUR0UD6up#OE[UR UR URURUR40UD6up#X lX0lX#4$![aVn[SRUR UR URURURX55eSnAff=f)NllTrr,zLCould not retrieve map with parameters: {}, {}, {}, {}, zoom={} {} Error: {})r isinstancerstrrr'r%r(r&r,r Exception ValueErrorformatimbbox_map)r0kwargsr>r)errs r4r/Place._get_mapvs ;; "#{{F8  $))S))(FFDFFDFFDFFDIIDHIIQWD&FFDFFDFFDFFDIIAGD x `ggFFDFFDFFDFFDIIv  s A/C&AC&& E0AEEcURnURnSnSnUc$[R"SS9upURnSnUR XVUS9 UR SSS 9 [UR[[45(aUcURRS 5nU(a [X5 UbUR US 9 U(aUR5 U$) at Plot a `Place` object ... Parameters ---------- ax : AxesSubplot Matplotlib axis with `x_lim` and `y_lim` set in Web Mercator (EPSG=3857). If not provided, a new 12x12 figure will be set and the name of the place will be added as title zoom : int/'auto' [Optional. Default='auto'] Level of detail for the basemap. If 'auto', if calculates it automatically. Ignored if `source` is a local file. interpolation : str [Optional. Default='bilinear'] Interpolation algorithm to be passed to `imshow`. See `matplotlib.pyplot.imshow` for further details. attribution : str [Optional. Defaults to attribution specified by the source of the map tiles] Text to be added at the bottom of the axis. This defaults to the attribution of the provider specified in `source` if available. Specify False to not automatically add an attribution, or a string to pass a custom attribution. Returns ------- ax : AxesSubplot Matplotlib axis with `x_lim` and `y_lim` set in Web Mercator (EPSG=3857) containing the basemap Examples -------- >>> lvl = cx.Place('Liverpool') >>> lvl.plot() NF) rDfigsizeT)extent interpolationXYxlabelylabel attributiontitle)r>r?pltsubplotsr#imshowsetr9rdictr getr set_axis_off) r0axr,rHrNr>r)rPaxisofffigs r4plot Place.plotsRWW}} :ll84GCJJEG " ? c#& dkkD,#7 8 8[=P++//-8K  B ,   FFF   OO  cSRURURURURR SS5nU$)Nz.Place : {} | n_tiles: {} | zoom : {} | im : {})r=r#r.r,r>shape)r0r%s r4__repr__Place.__repr__s= < C C JJ diir1B r])r)r?r(rr>r*r+r&r.rr#r%r$rr'r,r)__name__ __module__ __qualname____firstlineno____doc__gp geocoders Nominatim_default_user_agentr5r/r r r[ra__static_attributes__r]r4rrsN5t ''3F'G+Z2]PT<|r]rc[R"S[5 [U[5(dUnUnUnOTUR nUc4UR nUSLa#Uupp[X5up[X5upXX/nUc UROUnUc[R"SS9upURXqS9 URSSS9 UbURUS 9 U(a [X65 USLaUR5 U$) aPlot a map of the given place. Parameters ---------- place : instance of Place or ndarray The map to plot. If an ndarray, this must be an image corresponding to a map. If an instance of ``Place``, the extent of the image and name will be inferred from the bounding box. ax : instance of matplotlib Axes object or None The axis on which to plot. If None, one will be created. axis_off : bool Whether to turn off the axis border and ticks before plotting. attribution : str [Optional. Default to standard `ATTRIBUTION`] Text to be added at the bottom of the axis. Returns ------- ax : instance of matplotlib Axes object or None The axis on the map is plotted. zThe method `plot_map` is deprecated and will be removed from the library in future versions. Please use either `add_basemap` or the internal method `Place.plot`T)rorE)rGrIrJrKrO)warningswarnDeprecationWarningr9rr>r?rr#rQrRrSrTr rW) r#r)rPrXaxis_offlatlonrNr>r'r(r%r&rZs r4plot_maprus0 MM 0   eU # #  XX <>>D~! aa|a|a|$} % z,,x0IIbIFF#cF"  U(4  Ir])NNNTTN)rggeopyrhnumpyrmatplotlib.pyplotpyplotrQrptilerrrrrplottingr r r r xyzservicesr randomrandint_valrkobjectrrurmr]r4rsd3MM::$ yy!(/@F@HTX;r]