ó ÎrOc@sRddlZddlmZddlmZmZmZdefd„ƒYZdS(iÿÿÿÿN(tislice(tutiltunitstformattPointc Bs,eZdZedddejdejdejddƒZe j dee j ƒZ dddd „Zd „Zd „Zd „Zd „Zddddd„Zdd„Zdd„Zd„Zd„Zd„Zd„Zedd„ƒZed„ƒZed„ƒZed„ƒZed„ƒZRS(så 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 longitude, latitude, and altitude: >>> p1 = Point(41.5, -81, 0) >>> p2 = Point(latitude=41.5, longitude=-81) With a sequence of 0 to 3 values (longitude, latitude, 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 an object with a 'point' attribute, such as a `Location` instance: >>> p = Point(location) Give a string containing at least latitude and longitude: >>> p1 = Point('41.5,-81.0') >>> p2 = Point('41.5 N -81.0 W') >>> p3 = Point('-41.5 S, 81.0 E, 2.5km') >>> p4 = Point('23 26m 22s N 23 27m 30s E 21.0mi') >>> p5 = 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 tFLOATs \d+(?:\.\d+)?tDEGREEtPRIMEt DOUBLE_PRIMEtSEPs \s*[,;\s]\s*sé \s* (?P (?P-?%(FLOAT)s)(?:[%(DEGREE)s ][ ]* (?:(?P%(FLOAT)s)[%(PRIME)s'm][ ]*)? (?:(?P%(FLOAT)s)[%(DOUBLE_PRIME)s"s][ ]*)? )?(?P[NS])?) %(SEP)s (?P (?P-?%(FLOAT)s)(?:[%(DEGREE)s\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*$ cCs€|dko|dk}|rÅt|tjƒ rÅ|}|dkrFqÅt|tƒrb|j|ƒSt|tƒr~|j|ƒSyt|ƒ}Wn$t k r´t d|fƒ‚qÅX|j |ƒSnt |pÑdƒ}t |ƒdkrþ|ddd}nt |p dƒ}t |ƒdkr7|ddd}nt |pCdƒ}t t|ƒj|ƒ}||_||_||_|S(Ns(Failed to create Point instance from %r.iiZi´ih(tNonet isinstanceRt NUMBER_TYPESRt from_pointt basestringt from_stringtitert TypeErrort from_sequencetfloattabstsupert__new__tlatitudet longitudetaltitude(tclsRRRt single_argtargtseqtself((s*/var/www/python/geopy-trunk/geopy/point.pyRQs6       cCs|j|j|jf|S(N(RRR(Rtindex((s*/var/www/python/geopy-trunk/geopy/point.pyt __getitem__uscCs>|j|j|jg}|||<|\|_|_|_dS(N(RRR(RRtvaluetpoint((s*/var/www/python/geopy-trunk/geopy/point.pyt __setitem__xs cCst|j|j|jfƒS(N(RRRR(R((s*/var/www/python/geopy-trunk/geopy/point.pyt__iter__}scCsd|j|j|jfS(NsPoint(%r, %r, %r)(RRR(R((s*/var/www/python/geopy-trunk/geopy/point.pyt__repr__€sttmtsc Csdtjt|jƒdi|d6|d6|d6ƒ|jdkrHdpKdf}dtjt|jƒdi|d6|d6|d6ƒ|jdkršd pd f}||g}|dkrÎt|jƒ}n|rt|t ƒsìd }n|j |j |ƒƒnd j |ƒS( Ns%s %stsymbolstdegtarcmintarcsecitNtStEtWtkms, ( Rtformat_degreesRRRR tboolRR Rtappendtformat_altitudetjoin(RRtdeg_chartmin_chartsec_charRRt coordinates((s*/var/www/python/geopy-trunk/geopy/point.pyR…s00   cCsˆd|j}d|j}||g}|dkrDt|jƒ}n|r{t|tƒsbd}n|j|j|ƒƒndj |ƒS(Ns%sR1s, ( RRR R3RR RR4R5R6(RRRRR:((s*/var/www/python/geopy-trunk/geopy/point.pytformat_decimal™s     R1cCstj|j|ƒS(N(RtdistanceR(Rtunit((s*/var/www/python/geopy-trunk/geopy/point.pyR5§scCs |jƒS(N(R(R((s*/var/www/python/geopy-trunk/geopy/point.pyt__str__ªscCs|jdtjtjtjƒS(N(RR RRR(R((s*/var/www/python/geopy-trunk/geopy/point.pyt __unicode__­scCst|ƒt|ƒkS(N(ttuple(Rtother((s*/var/www/python/geopy-trunk/geopy/point.pyt__eq__²scCst|ƒt|ƒkS(N(R@(RRA((s*/var/www/python/geopy-trunk/geopy/point.pyt__ne__µsc CsÆ|dkp|jdƒ}t|p'dƒ}t|p9dƒ}t|pKdƒ}|s]|r•tjd|d|ƒ}|rˆ||8}q•||7}n|d kr¥|S|d kr¶| Std ƒ‚dS( Nit-t arcminutest arcsecondsR-R/R.R0s+Invalid direction! Should be one of [NSEW].(NR-R/(R.R0(t startswithRRtdegreesR t ValueError(RRHRERFt directiontnegativetmore((s*/var/www/python/geopy-trunk/geopy/point.pyt parse_degrees¸s     cCsp|dk rht|ƒ}id„d6d„d6d„d6d„d6d „d 6d „d 6}|||ƒS|SdS( NcSs|S(N((td((s*/var/www/python/geopy-trunk/geopy/point.pytÒsR1cSstjd|ƒS(Ntmeters(Rt kilometers(RN((s*/var/www/python/geopy-trunk/geopy/point.pyROÓsR'cSstjd|ƒS(Ntmiles(RRQ(RN((s*/var/www/python/geopy-trunk/geopy/point.pyROÔstmicSstjd|ƒS(Ntfeet(RRQ(RN((s*/var/www/python/geopy-trunk/geopy/point.pyROÕstftcSstjd|ƒS(Ntnautical(RRQ(RN((s*/var/www/python/geopy-trunk/geopy/point.pyROÖstnmcSstjd|ƒS(NRV(RRQ(RN((s*/var/www/python/geopy-trunk/geopy/point.pyRO×stnmi(R R(RR<R=t CONVERTERS((s*/var/www/python/geopy-trunk/geopy/point.pytparse_altitudeÍs        cCs×tj|j|ƒ}|rÇ|j|jdƒ|jdƒ|jdƒ|jdƒƒ}|j|jdƒ|jdƒ|jdƒ|jdƒƒ}|j|jd ƒ|jd ƒƒ}||||ƒStd ƒ‚d S( sè 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 the 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 tlatitude_degreestlatitude_arcminutestlatitude_arcsecondstlatitude_directiontlongitude_degreestlongitude_arcminutestlongitude_arcsecondstlongitude_directiontaltitude_distancetaltitude_unitss<Failed to create Point instance from string: unknown format.N(tretmatcht POINT_PATTERNRMtgroupRZRI(RtstringRfRRR((s*/var/www/python/geopy-trunk/geopy/point.pyRÝs$&       cCstt|dƒƒ}||ŒS(sÍ Create and return a new Point instance from any iterable with 0 to 3 elements. The elements, if present, must be latitude, longitude, and altitude, respectively. i(R@R(RRtargs((s*/var/www/python/geopy-trunk/geopy/point.pyRscCs||j|j|jƒS(s^ Create and return a new Point instance from another Point instance. (RRR(RR"((s*/var/www/python/geopy-trunk/geopy/point.pyR &sN(t__name__t __module__t__doc__tdictRRRRt UTIL_PATTERNSRetcompiletXRgR RR R#R$R%R;R5R>R?RBRCt classmethodRMRZRRR (((s*/var/www/python/geopy-trunk/geopy/point.pyRs60    $          > ( Ret itertoolsRtgeopyRRRtobjectR(((s*/var/www/python/geopy-trunk/geopy/point.pyts