{"id":31718541,"url":"https://github.com/aws-amplify/amplify-ios-maplibre","last_synced_at":"2025-10-09T02:52:51.502Z","repository":{"id":40258567,"uuid":"416419013","full_name":"aws-amplify/amplify-ios-maplibre","owner":"aws-amplify","description":"An adapter to leverage Amplify Geo with the map rendering of MapLibre.","archived":false,"fork":false,"pushed_at":"2024-09-18T19:10:34.000Z","size":4514,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":44,"default_branch":"main","last_synced_at":"2025-08-27T04:46:43.427Z","etag":null,"topics":["aws","aws-amplify","geolocation","ios","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","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/aws-amplify.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-10-12T16:42:18.000Z","updated_at":"2025-06-19T19:36:45.000Z","dependencies_parsed_at":"2022-08-17T20:55:17.967Z","dependency_job_id":"f8df5d16-9397-4f30-b5af-c686f8bf2b48","html_url":"https://github.com/aws-amplify/amplify-ios-maplibre","commit_stats":{"total_commits":31,"total_committers":7,"mean_commits":4.428571428571429,"dds":0.4193548387096774,"last_synced_commit":"d4c7adeb0bc6d43e40eb3fbf40a3ac19425a2843"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/aws-amplify/amplify-ios-maplibre","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-amplify%2Famplify-ios-maplibre","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-amplify%2Famplify-ios-maplibre/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-amplify%2Famplify-ios-maplibre/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-amplify%2Famplify-ios-maplibre/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aws-amplify","download_url":"https://codeload.github.com/aws-amplify/amplify-ios-maplibre/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-amplify%2Famplify-ios-maplibre/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000764,"owners_count":26082906,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["aws","aws-amplify","geolocation","ios","swift"],"created_at":"2025-10-09T02:52:46.940Z","updated_at":"2025-10-09T02:52:51.494Z","avatar_url":"https://github.com/aws-amplify.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"## AmplifyMapLibreAdapter for iOS\n\nThe AmplifyMapLibreAdapter is a library that combines the Amplify Geo category and the MapLibre SDK.\n\n- Registers a custom URL protocol with MapLibre that intercepts and signs calls to AWS Location endpoints. This registration occurs automatically the first time AmplifyMapLibreAdapter is used to create a map.\n\n- Brokers communication between Amplify and MapLibre by providing functions and extensions that simplify using Amplify Geo with MapLibre.\n\n- Provide SwiftUI support for MapLibre that adds `AMLMapView` (Amplify MapLibre MapView) and `AMLMapCompositeView` Views around MapLibre's MLNMapView. This introduces SwiftUI support to the MapLibre SDK for iOS. It provides a subset of MLNMapView functionality that can be used for displaying and interacting with a map; providing APIs to track state changes, inject custom implementations for user interaction, and define settings.\n\n## Usage\n\n[Getting Started Guide](https://docs.amplify.aws/lib/geo/getting-started/q/platform/ios/)\n\n[API Documentation](https://aws-amplify.github.io/amplify-ios-maplibre/docs/)\n\n[Examples](Examples/AMLExamples/README.md)\n\n## Platform Support\n\nAmplifyMapLibreAdapter supports iOS 13 and above.\n\n## Installation\n\n### Swift Package Manager\n\nSwift Pacakge Manager is distributed with Xcode. To add AmplifyMapLibreAdapter to your iOS project, take the following steps: \n1. Open your project in Xcode.\n2. Select your application in the **Project Navigator**.\n3. Select your project in the **Project List** pane.\n4. Select **Package Dependencies**.\n5. Click the + (plus) button.\n6. Enter the AmplifyMapLibreAdapter GitHub repo URL (`https://github.com/aws-amplify/amplify-ios-maplibre`) in the search bar labeled **Search or Enter Package URL**.\n7. Click **Add Package** and select your desired **Dependency Rule**\n8. Select the targets you would like to add.\n    - **AmplifyMapLibreAdapter** will allow you to create a `MLNMapView` configured to work with Amplify Geo.\n    - **AmplifyMapLibreUI** provides SwiftUI Map Views, `AMLMapView` and `AMLMapCompositeView`. Additionally, it also provides other map related UI components with applicable functionality, such as a `AMLSearchBar`, `AMLPlaceList`, `AMLMapControlView`, and more. All of which seamlessly integrate with Amplify Geo.\n\n## Reporting Bugs/Feature Requests\n\nWe welcome you to use the GitHub issue tracker to report bugs or suggest features.\n\nWhen filing an issue, please check [exisiting open](https://github.com/aws-amplify/amplify-ios-maplibre/issues), or [recently closed](https://github.com/aws-amplify/amplify-ios-maplibre/issues?utf8=%E2%9C%93\u0026q=is%3Aissue%20is%3Aclosed%20), issues to make sure somebody else hasn't already reported the issue. Please try to include as much information as you can. Details like these are incredibly useful:\n\n* Expected behavior and observed behavior.\n* A reproducible test case or series of steps.\n* The version of our code being used.\n* Any modications you've made relecant to the bug.\n* Anything custom about your environment or deployment.\n* Stack Trace in text form (if applicable).\n\n## Open Source Contributions\n\nWe welcome and and all contributions from the community! Make sure you read through our contribution guide [here](https://github.com/aws-amplify/amplify-ios-maplibre/blob/main/CONTRIBUTING.md) before submitting any PR's.\n\n## Security\n\nSee [CONTRIBUTING](https://github.com/aws-amplify/amplify-ios-maplibre/blob/main/CONTRIBUTING.md#security-issue-notifications) for more information.\n\n## License\n\nThis project is licensed under the Apache-2.0 License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-amplify%2Famplify-ios-maplibre","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faws-amplify%2Famplify-ios-maplibre","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-amplify%2Famplify-ios-maplibre/lists"}