gNA dZddlZddlZddlZddlmZddlmZm Z ddl m Z m Z ddl mZmZmZmZmZej&ddeeed d zej(ej*zZd Zd ZGd dZy)z! :class:`.Point` data structure. N)islice)fmodisfinite)unitsutil)DEGREE DOUBLE_PRIMEPRIMEformat_degreesformat_distancea& .*? (?P (?P[NS])?[ ]* (?P[+-]?%(FLOAT)s)(?:[%(DEGREE)sD\*\u00B0\s][ ]* (?:(?P%(FLOAT)s)[%(PRIME)s'm][ ]*)? (?:(?P%(FLOAT)s)[%(DOUBLE_PRIME)s"s][ ]*)? )?(?P[NS])?) %(SEP)s (?P (?P[EW])?[ ]* (?P[+-]?%(FLOAT)s)(?:[%(DEGREE)sD\*\u00B0\s][ ]* (?:(?P%(FLOAT)s)[%(PRIME)s'm][ ]*)? (?:(?P%(FLOAT)s)[%(DOUBLE_PRIME)s"s][ ]*)? )?(?P[EW])?)(?: %(SEP)s (?P (?P[+-]?%(FLOAT)s)[ ]* (?Pkm|m|mi|ft|nm|nmi)))? \s*$ z \d+(?:\.\d+)?z \s*[,;/\s]\s*)FLOATrr r SEPcZ|dz}t||xsd}|| kr||zS||k\r||z S|S)zC Normalize angle `x` to be within `[-limit; limit)` range. g@)r)xlimit double_limitmodulos K/var/www/api/v1/venv_getwork_v1/lib/python3.12/site-packages/geopy/point.py_normalize_angler+sI3;L !\ " )cF  $$  $$ McVt|xsd}t|xsd}t|xsd}td|||fD}|std|||fdt|dkDr't j dt dtd t|d kDr t|d }|||fS) Nrc32K|]}t|ywN)r).0rs r z)_normalize_coordinates..=sM-L -Lsz"Point coordinates must be finite. z has been passed as coordinates.Za4Latitude normalization has been prohibited in the newer versions of geopy, because the normalized value happened to be on a different pole, which is probably not what was meant. If you pass coordinates as positional args, please make sure that the order is (latitude, longitude) or (y, x) in Cartesian terms.) stacklevelz(Latitude must be in the [-90; 90] range.gf@)floatall ValueErrorabswarningswarn UserWarningr)latitude longitudealtitude is_all_finites r_normalize_coordinatesr,8sX_%Hi&3'IX_%HMh 8-LMMM /7H.MPQ Q 8}r L "a  1CDD 9~%Y6 Y ((rceZdZdZdZeZdfd ZdZdZdZ dZ dZ d Z dd Z dd Zdd Zdd ZdZdZdZeddZedZedZedZedZxZS)Pointu? A geodetic point with latitude, longitude, and altitude. Latitude and longitude are floating point values in degrees. Altitude is a floating point value in kilometers. The reference level is never considered and is thus application dependent, so be consistent! The default for all values is 0. Points can be created in a number of ways... With latitude, longitude, and altitude:: >>> p1 = Point(41.5, -81, 0) >>> p2 = Point(latitude=41.5, longitude=-81) With a sequence of 2 to 3 values (latitude, longitude, altitude):: >>> p1 = Point([41.5, -81, 0]) >>> p2 = Point((41.5, -81)) Copy another `Point` instance:: >>> p2 = Point(p1) >>> p2 == p1 True >>> p2 is p1 False Give a string containing at least latitude and longitude:: >>> p = Point('41.5,-81.0') >>> p = Point('+41.5 -81.0') >>> p = Point('41.5 N -81.0 W') >>> p = Point('-41.5 S, 81.0 E, 2.5km') >>> p = Point('23 26m 22s N 23 27m 30s E 21.0mi') >>> p = Point('''3 26' 22" N 23 27' 30" E''') Point values can be accessed by name or by index:: >>> p = Point(41.5, -81.0, 0) >>> p.latitude == p[0] True >>> p.longitude == p[1] True >>> p.altitude == p[2] True When unpacking (or iterating), a ``(latitude, longitude, altitude)`` tuple is returned:: >>> latitude, longitude, altitude = p Textual representations:: >>> p = Point(41.5, -81.0, 12.3) >>> str(p) # same as `p.format()` '41 30m 0s N, 81 0m 0s W, 12.3km' >>> p.format_unicode() '41° 30′ 0″ N, 81° 0′ 0″ W, 12.3km' >>> repr(p) 'Point(41.5, -81.0, 12.3)' >>> repr(tuple(p)) '(41.5, -81.0, 12.3)' r(r)r*c|duxr |duxr|du}|r{t|tjsa|}t|tr|j |St|t r|j |S t|}|j|S|r tdt|||\}}}t|5|}||_||_||_|S#t$rtd|dwxYw)z :param float latitude: Latitude of point. :param float longitude: Longitude of point. :param float altitude: Altitude of point. Nz%Failed to create Point instance from .zA single number has been passed to the Point constructor. This is probably a mistake, because constructing a Point with just a latitude seems senseless. If this is exactly what was meant, then pass the zero longitude explicitly to get rid of this error.) isinstancer NUMBER_TYPESr. from_pointstr from_stringiter from_sequence TypeErrorr#r,super__new__r(r)r*) clsr(r)r* single_argargseqself __class__s rr;z Point.__new__s  T)Ti4.?THPTDT j43D3DEC#u%~~c**C%s++2s)C ,,S11 ,  #8Y A &)Xws#  "   1!#FIKs 3 CC,ct||Srtuple)r@indexs r __getitem__zPoint.__getitem__sT{5!!rcZt|}|||<t|\|_|_|_yr)listr,r(r)r*)r@rEvaluepoints r __setitem__zPoint.__setitem__s-T e "E * 5 t~t}rcZt|j|j|jfSr)r7r(r)r*r@s r__iter__zPoint.__iter__s T]]DNNDMMBCCrct|SrrCrMs r __getstate__zPoint.__getstate__s T{rc.|\|_|_|_yrr/)r@states r __setstate__zPoint.__setstate__s7<4 t~t}rcdt|zS)NzPoint(%r, %r, %r)rCrMs r__repr__zPoint.__repr__s"U4[00rctt|j|||dd|jdk\xrdxsd}tt|j|||dd|jdk\xrdxsd}||g}|t |j }|r2t |tsd }|j|j|d j|S) a Format decimal degrees (DD) to degrees minutes seconds (DMS):: >>> p = Point(41.5, -81.0, 12.3) >>> p.format() '41 30m 0s N, 81 0m 0s W, 12.3km' >>> p = Point(41.5, 0, 0) >>> p.format() '41 30m 0s N, 0 0m 0s E' See also :meth:`.format_unicode`. :param bool altitude: Whether to include ``altitude`` value. By default it is automatically included if it is non-zero. )degarcminarcsec)symbols rNSEWkm, ) r r$r(r)boolr*r2r5appendformat_altitudejoin)r@r*deg_charmin_charsec_charr(r) coordinatess rformatz Point.formats" 3t}}-8x8  MMQ  &3 -# -   3t~~.8x9  NNa  'C .3 .   +  DMM*H h,   t33H= >yy%%rcB|j|tttS)u~ :meth:`.format` with pretty unicode chars for degrees, minutes and seconds:: >>> p = Point(41.5, -81.0, 12.3) >>> p.format_unicode() '41° 30′ 0″ N, 81° 0′ 0″ W, 12.3km' :param bool altitude: Whether to include ``altitude`` value. By default it is automatically included if it is non-zero. )rjrr r )r@r*s rformat_unicodezPoint.format_unicodes{{ fe\  rct|jt|jg}|t|j}|r2t |tsd}|j |j|dj|S)a Format decimal degrees with altitude:: >>> p = Point(41.5, -81.0, 12.3) >>> p.format_decimal() '41.5, -81.0, 12.3km' >>> p = Point(41.5, 0, 0) >>> p.format_decimal() '41.5, 0.0' :param bool altitude: Whether to include ``altitude`` value. By default it is automatically included if it is non-zero. r`ra) r5r(r)rbr*r2rcrdre)r@r*ris rformat_decimalzPoint.format_decimalsn4==)3t~~+>?  DMM*H h,   t33H= >yy%%rc0t|j|S)am Format altitude with unit:: >>> p = Point(41.5, -81.0, 12.3) >>> p.format_altitude() '12.3km' >>> p = Point(41.5, -81.0, 0) >>> p.format_altitude() '0.0km' :param str unit: Resulting altitude unit. Supported units are listed in :meth:`.from_string` doc. )unit)r r*)r@rps rrdzPoint.format_altitude)st}}488rc"|jSr)rjrMs r__str__z Point.__str__9s{{}rct|tjjstSt |t |k(Sr)r2 collectionsabcIterableNotImplementedrDr@others r__eq__z Point.__eq__<s/%!9!9:! !T{eEl**rc||k( Srrxs r__ne__z Point.__ne__AsEM""rct|}|dk}t|}t|}|s|r$tj||}|r||z}n||z }|dvr|S|dvr| Std)z Convert degrees, minutes, seconds and direction (N, S, E, W) to a single degrees number. :rtype: float r) arcminutes arcseconds)Nr\r^)r]r_z+Invalid direction! Should be one of [NSEW].)r!rdegreesr#)r<rrr directionnegativemores r parse_degreeszPoint.parse_degreesDs}.Q;:& :& ==J:ND44 ( (N * $8OJK Krc|&t|}ddddddd} |||S|S#t$rtd|jzwxYw) a Parse altitude managing units conversion:: >>> Point.parse_altitude(712, 'm') 0.712 >>> Point.parse_altitude(712, 'km') 712.0 >>> Point.parse_altitude(712, 'mi') 1145.852928 :param float distance: Numeric value of altitude. :param str unit: ``distance`` unit. Supported units are listed in :meth:`.from_string` doc. c|Srr|ds rz&Point.parse_altitude..rsrc.tj|S)N)metersr kilometersrs rrz&Point.parse_altitude..ssu//q9rc.tj|S)N)milesrrs rrz&Point.parse_altitude..ts 0 0q 9rc.tj|S)N)feetrrs rrz&Point.parse_altitude..us 0 0a 8rc.tj|SN)nauticalrrs rrz&Point.parse_altitude..vs 0 0! .ws!1!11!=r)r`mmiftnmnmiz*Bad distance unit specified, valid are: %r)r!KeyErrorNotImplementedErrorkeys)r<distancerp CONVERTERSs rparse_altitudezPoint.parse_altitude_sz  XH!998<= J 'z$'11O  )@OO%& s +&AcLtj|jtjdd|}|rbd}|j dr|j d}n"|j dr|j d}d}|j dr|j d}n"|j dr|j d}|j |j dxsd |j d xsd |j d xsd |}|j |j d xsd |j d xsd |j dxsd |}|j |j d|j d}||||Std)u= Create and return a ``Point`` instance from a string containing latitude and longitude, and optionally, altitude. Latitude and longitude must be in degrees and may be in decimal form or indicate arcminutes and arcseconds (labeled with Unicode prime and double prime, ASCII quote and double quote or 'm' and 's'). The degree symbol is optional and may be included after the decimal places (in decimal form) and before the arcminutes and arcseconds otherwise. Coordinates given from south and west (indicated by S and W suffixes) will be converted to north and east by switching their signs. If no (or partial) cardinal directions are given, north and east are the assumed directions. Latitude and longitude must be separated by at least whitespace, a comma, or a semicolon (each with optional surrounding whitespace). Altitude, if supplied, must be a decimal number with given units. The following unit abbrevations (case-insensitive) are supported: - ``km`` (kilometers) - ``m`` (meters) - ``mi`` (miles) - ``ft`` (feet) - ``nm``, ``nmi`` (nautical miles) Some example strings that will work include: - ``41.5;-81.0`` - ``41.5,-81.0`` - ``41.5 -81.0`` - ``41.5 N -81.0 W`` - ``-41.5 S;81.0 E`` - ``23 26m 22s N 23 27m 30s E`` - ``23 26' 22" N 23 27' 30" E`` - ``UT: N 39°20' 0'' / W 74°35' 0''`` z''"Nlatitude_direction_frontlatitude_direction_backlongitude_direction_frontlongitude_direction_backlatitude_degreesrlatitude_arcminuteslatitude_arcsecondslongitude_degreeslongitude_arcminuteslongitude_arcsecondsaltitude_distancealtitude_unitszVC^$ t9q=@A ADzrcR||j|j|jS)ze Create and return a new ``Point`` instance from another ``Point`` instance. r/)r<rJs rr4zPoint.from_points 5>>5??ENNCCr)NNN)Nrsr)r`)__name__ __module__ __qualname____doc__ __slots__rr;rFrKrNrPrSrUrjrlrnrdrrrzr} classmethodrrr6r8r4 __classcell__)rAs@rr.r.Ts?B6I!M(T"+ D=1%&N &29 + #LL4!!FGGR  DDrr.)rcollections.abcrtrr% itertoolsrmathrrgeopyrr geopy.formatrr r r r compileVERBOSEUNICODErrr,r.r|rrrs~ UU *   )4:: 5 : )8LDLDr