Metadata-Version: 2.1
Name: fiftyone_location
Version: 4.3.2
Summary: The 51Degrees Pipeline API is a generic web request intelligence and data processing solution with the ability to add a range of 51Degrees and/or custom plug ins (Engines). This repository contains the geo-location engines for the Python implementation of the Pipeline API.
Home-page: https://51degrees.com/
Author: 51Degrees
Author-email: support@51degrees.com
License: EUPL-1.2
Description: # 51Degrees Geo-Location Engines
        
        ![51Degrees](https://51degrees.com/DesktopModules/FiftyOne/Distributor/Logo.ashx?utm_source=github&utm_medium=repository&utm_content=readme_main&utm_campaign=python-open-source) 
        **v4 Location Python**
        
        [Developer Documentation](https://51degrees.com/location-python/index.html "Developer documentation")
        
        ## Introduction
        
        This project contains the geo-location engines for the Python implementation of the 51Degrees Pipeline API.
        
        The Pipeline is a generic web request intelligence and data processing solution with the ability to add a range of 51Degrees and/or custom plug ins (Engines) 
        
        ## Requirements
        
        * Python 3.5+
        * The `flask` python library to run the web examples
        
        ## Installation and Examples
        
        ### From PyPI
        
        `pip install fiftyone-location`
        
        You can confirm this is working with the following micro-example.
        
        * Create a resource key for free with the 51Degrees [configurator](https://configure.51degrees.com/6CTsmbPx). This defines the properties you want to access.
        * On the 'implement' page of the configurator, copy the resource key and replace YOUR_RESOURCE_KEY in the example below. Save this as examplelocation.py
        * Run the example with `python examplelocation.py`
        * Feel free to try different locations and property values.
        
        ```
        from fiftyone_location.location_pipelinebuilder import LocationPipelineBuilder
        pipeline = LocationPipelineBuilder(resource_key="YOUR_RESOURCE_KEY").build()
        fd = pipeline.create_flowdata()
        fd.evidence.add("query.51D_Pos_latitude", "40.730610")
        fd.evidence.add("query.51D_Pos_longitude", "-73.935242")
        fd.process()
        print(fd.location.town.value())
        ```
        
        For more in-depth examples, check out the [examples](https://51degrees.com/documentation/_examples__reverse_geocoding__index.html) page in the documentation.
        
        ### From GitHub
        
        If you've cloned the GitHub repository, you will be able to run the examples directly:
        
        `python -m examples.cloud.gettingstarted`
        
        To run the web example navigate into Examples folder:
        
        #### Linux
        
        Execute `export FLASK_APP=web` where `web` is the example file, and start your application via `flask run`.
        
        #### Windows
        
        Execute `$env:FLASK_APP = "web"` where `web` is the example file, and start your application via `flask run`.
        
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: European Union Public Licence 1.2 (EUPL 1.2)
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.5
Description-Content-Type: text/markdown
