{"id":18271394,"url":"https://github.com/InfiniteLoopDK/ILGeoNames","last_synced_at":"2025-04-05T01:31:29.511Z","repository":{"id":1394561,"uuid":"1394869","full_name":"InfiniteLoopDK/ILGeoNames","owner":"InfiniteLoopDK","description":"Various helper classes for accessing the free geocoding services at geonames.org","archived":false,"fork":false,"pushed_at":"2011-12-06T00:29:08.000Z","size":200,"stargazers_count":98,"open_issues_count":3,"forks_count":19,"subscribers_count":6,"default_branch":"develop","last_synced_at":"2024-11-05T11:53:54.138Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://www.infinite-loop.dk/developer/ilgeonames/","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/InfiniteLoopDK.png","metadata":{"files":{"readme":"README.mdown","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-02-21T21:52:31.000Z","updated_at":"2023-11-06T07:09:06.000Z","dependencies_parsed_at":"2022-08-16T13:15:18.651Z","dependency_job_id":null,"html_url":"https://github.com/InfiniteLoopDK/ILGeoNames","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InfiniteLoopDK%2FILGeoNames","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InfiniteLoopDK%2FILGeoNames/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InfiniteLoopDK%2FILGeoNames/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InfiniteLoopDK%2FILGeoNames/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/InfiniteLoopDK","download_url":"https://codeload.github.com/InfiniteLoopDK/ILGeoNames/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247276043,"owners_count":20912286,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-05T11:39:16.480Z","updated_at":"2025-04-05T01:31:24.504Z","avatar_url":"https://github.com/InfiniteLoopDK.png","language":"Objective-C","readme":"# ILGeoNames\n\nILGeoNames provides Objective C wrapper classes for accessing the free geocoding services at [GeoNames.org](http://www.geonames.org) from iOS.\n\nUnlike the geocoding services provided by Google which have various restricting license terms, GeoNames allows you to use their data for practically any purpose as long as you give [proper credit](http://www.geonames.org/export/).\n\n## Setting up the sample application\n\nIn order to be able to use this sample application you need to perform a few additional steps first:\n\n- Sign up for a free account a geonames.org\n- Enter your new geonames account information in SampleAppDelegate.m\n- Download JSONKit\n- Download OCMock\n\nEach of these steps are detailed in more details below.\n\n### Sign up for a free GeoNames account\n\nIf you do not already have an account with GeoNames, you first need to go to http://www.geonames.org/login and sign-up for a free account. Shortly after you should get an confirmation email with information on how to activate your account.\n\nOnce you have activated your account you also need to enable it to use the free web service. This is done from your GeoNames account page by simply clicking a link. Once enabled, your account is ready to be used with the various geocoding services.\n\n### Setting up account information\n\nOpen the SampleApp.xcodeproj file and locate the file named `SampleAppDelegate.m`\nLocate the following line near the top of the file and replace the account information with your own.\n\n\tstatic NSString *kGeoNamesAccountName = @\"ilgeonamessample\";\n\n### Download JSONKit\n\nThe ILGeoNames classes makes use of JSONKit by John Engelhart. In order to be able to build the sample project - and your own for that matter - you need to download a copy of the JSONKit code from [GitHub](http://github.com/johnezang/JSONKit)\n\nOnce downloaded, place the JSONKit folder next to the SampleApp folder. Alternatively, if you already have your own fork of JSONKit, just point the sample project to your local repository.\n \n### Download OCMock\n\nThe UnitTest code makes use of OCMock from Mulle Kybernetik. In order to be able to run the unit tests you will need to download the latest version of OCMock from [Mulle Kybernetik](http://www.mulle-kybernetik.com/software/OCMock/)\n\nOnce downloaded, unpack it and place it next to the SampleApp folder. You may need to remove the version from the folder name so it\ns just called OCMock.\n\nYou should now be ready to compile and run the sample application. The application shows examples on how to use the following classes:\n\n- ILGeoNamesLookup, the basic wrapper for accessing geonames.org\n- ILGeoNamesSearchController, a search controller for online search of named locations\n\nFor more information about ILGeoNames and how to use it, please visit http://www.infinite-loop.dk/developer/ilgeonames/\n\n### Building Xcode Documentation\n\nILGeoNames is documented in the header files using the appledoc syntax. The SampleApp contains a target called \"Documentation\" which will build the documentation and install it for use inside Xcode as a searchable and browsable docset.\nIn order to be able to build it you will need to install appledoc on your own computer. You can get appledoc from [GitHub](http://github.com/tomaz/appledoc).\nFor more information about how to setup and build the documentation you can read this [short tutorial](http://wp.me/p1xKtH-52).\n\nFeel free to add enhanchements, bug fixes, changes and provide them back to the community!\n\n\nThanks,\n\nClaus Broch\n","funding_links":[],"categories":["etc"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FInfiniteLoopDK%2FILGeoNames","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FInfiniteLoopDK%2FILGeoNames","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FInfiniteLoopDK%2FILGeoNames/lists"}