Package: pyonemap
PyOneMap - Python Wrapper for SLA's OneMap APIPyOneMap is a Python package that provides a convenient and easy-to-use interface for interacting with the Singapore Land Authority's (SLA) OneMap API. With PyOneMap, you can retrieve various geospatial data and information from OneMap's services directly from your Python code.This is built using theAPI docrelease in 2023. The old API documentation and APIs will be available until 31 August 2023.FeaturesRetrieve location details such as addresses, postal codes, and coordinates.Search for places of interest, amenities, and landmarks in Singapore.Perform geocoding and reverse geocoding operations effortlessly.Access map layers and thematic data provided by the OneMap API.InstallationYou can install PyOneMap using pip:pipinstallpyonemapUsagefrompyonemapimportOneMap# Initialize the OneMapAPI clientonemap=OneMap('<--Insert your OneMap API token here-->')# Get location detailslocation=onemap.search("5 Havelock Road")print(location)geocode=onemap.revGeoCodeXy(24291.97788882387,31373.0117224489)print(geocode)geocode=onemap.revGeoCode(1.3254295,103.9005321)print(geocode)Exampleaccess_token=os.environ.get("ONEMAP_TOKEN")onemap=OneMap(access_token)location=onemap.search("200640",'Y','Y')print(location)geocode=onemap.reverseGeocode.revGeoCodeXy(24291.97788882387,31373.0117224489)geocode=onemap.reverseGeocode.revGeoCode(1.3254295,103.9005321)print(geocode)route=onemap.routing.route(1.320981,103.844150,1.326762,103.8559)print(route['requestParameters']['preferredRoutes'])coordinate=onemap.converter.convert4326to3857(1.319728905,103.8421581)print(coordinate)coordinate=onemap.converter.convert4326to3414(1.319728905,103.8421581)print(coordinate)coordinate=onemap.converter.convert3414to3857(28983.788791079794,33554.509813284)print(coordinate)coordinate=onemap.converter.convert3414to4326(28983.788791079794,33554.5098132845)print(coordinate)coordinate=onemap.converter.convert3857to3414(146924.54200324757,11559656.16256661)print(coordinate)coordinate=onemap.converter.convert3857to4326(146924.54200324757,11559656.16256661)print(coordinate)# {'latitude': 1.3197289050000036, 'longitude': 103.8421581}themeStatus=onemap.themes.checkThemeStatus('kindergartens')print(themeStatus)# {'UpdatedFile': True}themeInfo=onemap.themes.getThemeInfo('kindergartens')print(themeInfo)allThemes=onemap.themes.getAllThemesInfo()print(f'Found{len(allThemes["Theme_Names"])}themes.')searchTheme='dengue_cluster'theme=onemap.themes.retrieveTheme(searchTheme)print(f'{len(theme["SrchResults"])}of{searchTheme}found.')boundary='1.291789%2C103.7796402%2C1.3290461%2C103.8726032'exTheme=onemap.themes.retrieveTheme(searchTheme,boundary)print(f'{len(theme["SrchResults"])}of{searchTheme}found (with boundaries).')year='2019'allPlanningArea=onemap.planningArea.getAllPlanningarea(year)print(f'{len(allPlanningArea["SearchResults"])}planning areas found for the year{year}.')planningAreaNames=onemap.planningArea.getPlanningareaNames(year)print(f'{len(planningAreaNames)}planning area names found for the year{year}.')lat=1.3lon=103.8planningArea=onemap.planningArea.getPlanningArea(lat,lon,year)print(f'({lat},{lon}) is located in planning area{planningArea[0]["pln_area_n"]}in the year of{year}.')print(onemap.populationQuery.getEconomicStatus("Bedok",2010))print(onemap.populationQuery.getEducationAttending("Bedok",2020))print(onemap.populationQuery.getEthnicGroup("Bedok",2020))print(onemap.populationQuery.getHouseholdMonthlyIncomeWork("Bedok",2020))print(onemap.populationQuery.getHouseholdSize("Bedok",2020))print(onemap.populationQuery.getHouseholdStructure("Bedok",2020))print(onemap.populationQuery.getIncomeFromWork("Bedok",2020))print(onemap.populationQuery.getIndustry("Bedok",2020))print(onemap.populationQuery.getLanguageLiterate("Bedok",2020))print(onemap.populationQuery.getMaritalStatus("Bedok",2020))print(onemap.populationQuery.getModeOfTransportSchool("Bedok",2020))print(onemap.populationQuery.getModeOfTransportWork("Bedok",2020))print(onemap.populationQuery.getPopulationAgeGroup("Bedok",2020))print(onemap.populationQuery.getReligion("Bedok",2020))print(onemap.populationQuery.getSpokenAtHome("Bedok",2020))print(onemap.populationQuery.getTenancy("Bedok",2020))print(onemap.populationQuery.getTypeOfDwellingHousehold("Bedok",2020))print(onemap.populationQuery.getTypeOfDwellingPop("Bedok",2020))Use case: Walk distance between 2 locationsfrompyonemapimportOneMap# Obtain access token using email and password.response=OneMap.getToken('your_email@email.com','your_password')access_token=response['access_token']# Instantiate OneMap object for API query.onemap=OneMap(access_token)# Search for a address using postal code.start=onemap.search("380016",'Y','Y')end=onemap.search("658713",'Y','Y')route=onemap.routing.route(start["results"][0]["LATITUDE"],start["results"][0]["LONGITUDE"],end["results"][0]["LATITUDE"],end["results"][0]["LONGITUDE"],"walk")route['route_summary']# {'start_point': '', 'end_point': '', 'total_time': 11662, 'total_distance': 16198}Unit Testpython3-munittestdiscover-stests-p"test_*.py"Building and Uploading$ python3 setup.py sdist bdist_wheel
$ twine upload ./dist/*Sourcehttps://github.com/chengguan/pyonemapContributingContributions are welcome! If you find any issues or have suggestions for improvements, feel free to open an issue or submit a pull request.LicenseThis project is licensed under the MIT License - see the LICENSE file for details.