{"id":23988847,"url":"https://github.com/philip-bui/mapkit-search-view","last_synced_at":"2025-04-14T12:20:22.231Z","repository":{"id":62447528,"uuid":"170964113","full_name":"philip-bui/mapkit-search-view","owner":"philip-bui","description":"Apple Map's bottom sheet with animated gestures and state-machine transitions \u0026 scrolling.","archived":false,"fork":false,"pushed_at":"2024-04-12T13:19:21.000Z","size":1609,"stargazers_count":17,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-28T01:25:51.234Z","etag":null,"topics":["geocode","geosearch","ios","mapkit","mapkit-search"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/philip-bui.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}},"created_at":"2019-02-16T04:52:50.000Z","updated_at":"2024-10-08T21:40:24.000Z","dependencies_parsed_at":"2022-11-01T23:17:37.237Z","dependency_job_id":null,"html_url":"https://github.com/philip-bui/mapkit-search-view","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philip-bui%2Fmapkit-search-view","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philip-bui%2Fmapkit-search-view/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philip-bui%2Fmapkit-search-view/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philip-bui%2Fmapkit-search-view/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/philip-bui","download_url":"https://codeload.github.com/philip-bui/mapkit-search-view/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248877968,"owners_count":21176244,"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":["geocode","geosearch","ios","mapkit","mapkit-search"],"created_at":"2025-01-07T16:18:25.518Z","updated_at":"2025-04-14T12:20:22.196Z","avatar_url":"https://github.com/philip-bui.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/philip-bui/mapkit-search-view/raw/master/Images/MapKit.png\"\u003e\u003cimg src=\"https://github.com/philip-bui/mapkit-search-view/raw/master/Images/MapKit.png\" title=\"MapKit\" height=\"356\" width=\"200\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/philip-bui/mapkit-search-view/raw/master/Images/MapKit_Completions.png\"\u003e\u003cimg src=\"https://github.com/philip-bui/mapkit-search-view/raw/master/Images/MapKit_Completions.png\" title=\"Completions\" height=\"356\" width=\"200\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/philip-bui/mapkit-search-view/raw/master/Images/MapKit_MapItems.png\"\u003e\u003cimg src=\"https://github.com/philip-bui/mapkit-search-view/raw/master/Images/MapKit_MapItems.png\" title=\"MapItems\" height=\"356\" width=\"200\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# MapKit Search View\n[![CI Status](http://img.shields.io/travis/philip-bui/mapkit-search-view.svg?style=flat)](https://travis-ci.org/philip-bui/mapkit-search-view)\n[![CodeCov](https://codecov.io/gh/philip-bui/mapkit-search-view/branch/master/graph/badge.svg)](https://codecov.io/gh/philip-bui/mapkit-search-view)\n[![Version](https://img.shields.io/cocoapods/v/MapKitSearchView.svg?style=flat)](http://cocoapods.org/pods/MapKitSearchView)\n[![Carthage Compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)\n[![Platform](https://img.shields.io/cocoapods/p/MapKitSearchView.svg?style=flat)](http://cocoapods.org/pods/MapKitSearchView)\n[![License](https://img.shields.io/cocoapods/l/MapKitSearchView.svg?style=flat)](https://github.com/philip-bui/mapkit-search-view/blob/master/LICENSE)\n\nAn implementation of Apple's Map search view. \n\n- Animation between states and keyboard events.\n- Single gesture to scroll table view or drag down sheet.\n- Map user tracking (Follow, Follow with Heading).\n- Compass on non-north headings.\n- Customizable colors, search options.\n\n## Requirements\n\n- iOS 11.0+\n- Xcode 10.3+\n- Swift 4.2+\n\n## Installation\n\n### CocoaPods\n\n[CocoaPods](https://cocoapods.org) is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate MapKit Search View into your Xcode project using CocoaPods, specify it in your `Podfile`:\n\n```ruby\npod 'MapKitSearchView'\n```\n\n### Carthage\n\n[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate MapKit Search View into your Xcode project using Carthage, specify it in your `Cartfile`:\n\n```ogdl\ngithub \"philip-bui/mapkit-search-view\"\n```\n\n### Swift Package Manager\n\nThe [Swift Package Manager](https://swift.org/package-manager/) is a tool for automating the distribution of Swift code and is integrated into the `swift` compiler. It is in early development, but MapKit Search View does support its use on supported platforms.\n\nOnce you have your Swift package set up, adding MapKit Search View as a dependency is as easy as adding it to the `dependencies` value of your `Package.swift`.\n\n```swift\ndependencies: [\n    .package(url: \"https://github.com/philip-bui/mapkit-search-view.git\", from: \"1.0.0\"))\n]\n```\n\n## Usage\n\n```swift\nimport MapKitSearchView\n\nlet mapKitSearch = MapKitSearchViewController(delegate: self)\nmapKitSearch.tintColor = nil // Tints the close, userTracking and searchBar cursor colors.\nmapKitSearch.markerTintColor = nil // Tints map annotations and mapItem results.\nmapKitSearch.completionEnabled = true // Enables search completions as you type.\nmapKitSearch.geocodeEnabled = true // Enables geocoding when tapping on a map at street levels.\nmapKitSearch.userLocationRequest = .authorizedAlways // Requests location permission on view load.\n```\n\n## Improvements\n\n- Tablet / Landscape UI.\n- Additional information on duplicate place names.\n- Strings Localization.\n- Optional delegate methods to customize UI views (Search Bar, Table View rows).\n- Add Bottom Sheet states (collapsed, peek, expanded) for users to choose.\n\n## License\n\nMapKit Search View is available under the MIT license. [See LICENSE](https://github.com/philip-bui/mapkit-search-view/blob/master/LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilip-bui%2Fmapkit-search-view","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphilip-bui%2Fmapkit-search-view","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilip-bui%2Fmapkit-search-view/lists"}