{"id":22394378,"url":"https://github.com/akamai/urbancrawl-android","last_synced_at":"2025-03-26T22:42:07.956Z","repository":{"id":137717255,"uuid":"112614821","full_name":"akamai/UrbanCrawl-Android","owner":"akamai","description":"UrbanCrawl for Android is a reference application for Akamai's MAP SDK, by Akamai Developer","archived":false,"fork":false,"pushed_at":"2020-04-15T20:17:26.000Z","size":15206,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-01T04:26:38.937Z","etag":null,"topics":["android-library","android-references","android-sample-application","map-sdk"],"latest_commit_sha":null,"homepage":"https://developer.akamai.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/akamai.png","metadata":{"files":{"readme":"README.md","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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-11-30T13:31:06.000Z","updated_at":"2022-01-12T07:15:48.000Z","dependencies_parsed_at":null,"dependency_job_id":"02c84063-ab43-4fbb-9fc3-25041f52cdb4","html_url":"https://github.com/akamai/UrbanCrawl-Android","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akamai%2FUrbanCrawl-Android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akamai%2FUrbanCrawl-Android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akamai%2FUrbanCrawl-Android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akamai%2FUrbanCrawl-Android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akamai","download_url":"https://codeload.github.com/akamai/UrbanCrawl-Android/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245749796,"owners_count":20666084,"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":["android-library","android-references","android-sample-application","map-sdk"],"created_at":"2024-12-05T05:09:57.256Z","updated_at":"2025-03-26T22:42:07.951Z","avatar_url":"https://github.com/akamai.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"## What is Urban Crawl ##\n[Urban Crawl](https://play.google.com/store/apps/details?id=com.akamaidev.urbancrawlapp) is a tiny catalogue of a few selected cities that you can carry along, and explore the interesting places around these cities.\n\n### Why was Urban Crawl made ###\nUrban Crawl is a reference app from Akamai Developer, which demonstrates the capabilities and usage of Akamai's MAP SDK (https://developer.akamai.com/tools/map/)\n\nThe source code of Urban Crawl will help the app developers understand how MAP SDK can be used in different scenarios, and how different functions of MAP SDK work.\n\n### How to use the code ###\n- Clone the repository in Android Studio below 3.0 (See known issues)\n- Download a copy of MAP SDK bundle from your Luna Portal\n- Replace the following keys with your own keys:\n  -  MAP SDK License Key, in `res/xml/android_sdk_init.xml`\n  -  Replace font certificate keys, in `res/values/font_certs.xml`\n  -  If you're using Crashlytics, replace it with your own Crashlytics keys.\n-  Build and Run (and let us know if you run into any issues)\n\nDetailed instructions, to setup MAP SDK, can be found in the [Getting Started Guide](https://developer.akamai.com/blog/2017/03/20/getting-started-mobile-app-performance-map-sdk/). \n\n### How is the code organized ###\nThe following points will help the developer understand the structure of the code:\n\n- All the activities are located inside com.akamaidev.urbancrawl package.\n- The app uses simple MVP design pattern.\n- All the network activities are done either inside, or initiated from the Models.\n- All the Presenters and Models are located inside the `presenters` and `models` packages.\n- The app uses GSON to convert the JSON that the REST API returns, and these GSON classes are inside `jsonobjs` package.\n- All the other helper classes, are stored inside `helpers` package. These are classes which have methods for Analytics, Logging, Pickers, Events, and Adapters.\n \n##### MAP SDK Specific instructions #####\n\n- MAP SDK provides wrappers for OkHttp, Retrofit and Picasso, and these wrappers are stored under `MAPSDKWrappers` package.\n- The `Default Networking Client` uses `AkaUrlConnection` to make Internet calls using MAP SDK\n- The `CityDetailsModel` uses Retrofit to interact with our REST API, and uses the Retrofit Wrapper to make these HTTP calls go through MAP SDK\n- The ` PlaceModel` uses Volley to interact with the REST API, and uses the OkHttpWrapper to make the HTTP calls go through MAP SDK\n- All the models are stored in `models` package\n- The `ImageLoader` class contains the centralized Picasso code to download images, and uses the `AkaPicassoDownloader` as Picasso's downloader. the `ImageLoader` class is under `helper` package.\n\n\nThe code tries to be self explanatory, but write to us in case you have any questions.\n\n### Known Issues ###\n- Like few of the libraries, we have noticed build errors while compiling on Android Studio 3.0, mainly because of the new Gradle and Gradle Wrapper versions. We'll find a stable fix to it and update the repo as soon as possible.\n\nWrite to us at [devrel@akamai.com](mailto:devrel@akamai.com) for any questions.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakamai%2Furbancrawl-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakamai%2Furbancrawl-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakamai%2Furbancrawl-android/lists"}