{"id":18682865,"url":"https://github.com/yandex/mapkit-ios-demo","last_synced_at":"2025-04-05T18:09:15.366Z","repository":{"id":39717917,"uuid":"124944724","full_name":"yandex/mapkit-ios-demo","owner":"yandex","description":"MapKit iOS demo","archived":false,"fork":false,"pushed_at":"2025-03-26T15:53:00.000Z","size":77568,"stargazers_count":86,"open_issues_count":22,"forks_count":27,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-03-29T17:11:08.559Z","etag":null,"topics":["mapkit","mapkit-ios-demo","maps","swift","yandex"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yandex.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":"2018-03-12T20:04:26.000Z","updated_at":"2025-03-26T15:53:06.000Z","dependencies_parsed_at":"2023-01-19T19:33:38.910Z","dependency_job_id":"9ac408f6-276b-41ea-8a54-cd914143138c","html_url":"https://github.com/yandex/mapkit-ios-demo","commit_stats":{"total_commits":62,"total_committers":11,"mean_commits":5.636363636363637,"dds":0.7903225806451613,"last_synced_commit":"2c55895004642351ef52f5469718fe11b4ae745b"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yandex%2Fmapkit-ios-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yandex%2Fmapkit-ios-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yandex%2Fmapkit-ios-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yandex%2Fmapkit-ios-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yandex","download_url":"https://codeload.github.com/yandex/mapkit-ios-demo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247378149,"owners_count":20929297,"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":["mapkit","mapkit-ios-demo","maps","swift","yandex"],"created_at":"2024-11-07T10:13:02.982Z","updated_at":"2025-04-05T18:09:15.344Z","avatar_url":"https://github.com/yandex.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Yandex MapKit and NaviKit Demo Apps\n\nYandex MapKit and NaviKit are cross-platform libraries that let you use the capabilities of Yandex Maps in mobile applications for iOS and Android. Learn more about the MapKit and NaviKit SDKs on the [documentation](https://yandex.ru/dev/mapkit/doc/en/?from=github-demo) page.\n\nFor a quick start development with the MapKit and NaviKit SDKs visit the following pages:\n- [Getting started with MapKit SDK](https://yandex.ru/dev/mapkit/doc/en/ios/generated/getting_started)\n- [Getting started with NaviKit SDK](https://yandex.ru/dev/mapkit/doc/en/ios/generated/navigation/getting_started) \n\nThe current repository contains sample code for how to use the MapKit and NaviKit SDKs for iOS applications.\n\n## Project structures\n\nThere are three iOS projects in the repository:\n\n1. [__`MapkitSamples`__](mapkit-samples): Contains several iOS applications with sample code in Swift, all of which are demonstrated in the MapKit SDK Tutorials documentation.\n\n    - [`MapWithPlacemark`](mapkit-samples/MapWithPlacemark): A simple MapKit SDK application with [Getting started with MapKit for iOS](https://yandex.ru/dev/mapkit/doc/en/ios/generated/getting_started) information.\n\n    - [`MapObjects`](mapkit-samples/MapObjects): Using the [Map Objects](https://yandex.ru/dev/mapkit/doc/en/ios/generated/tutorials/map_objects) API to add objects to the map.\n\n    - [`MapInteraction`](mapkit-samples/MapInteraction): Examples from the [Map Interaction](https://yandex.ru/dev/mapkit/doc/en/ios/generated/tutorials/map_interaction) tutorial.\n\n    - [`MapSearch`](mapkit-samples/MapSearch): Examples of how to use the [Search](https://yandex.ru/dev/mapkit/doc/en/ios/generated/tutorials/map_search) and [Geosuggest](https://yandex.ru/dev/mapkit/doc/en/ios/generated/tutorials/map_suggest) functionality.\n\n    - [`MapRouting`](mapkit-samples/MapRouting): About the [Routes](https://yandex.ru/dev/mapkit/doc/en/ios/generated/tutorials/map_routes) and [Routing](https://yandex.ru/dev/mapkit/doc/en/ios/generated/tutorials/map_routing) API.\n\n2. [__`MapKitDemo`__](mapkit-demo): A demo application that contains the basic functionality of the lite and full MapKit SDK versions. It is not supported with Tutorials documentation, unlike the `MapkitSamples` project.\n\n3. [__`NaviKitDemo`__](navikit-demo): A demo application showcasing the basic navigation features you can implement with NaviKit SDK.\n\n## Build locally\n\n1. Clone the repository:\n    ```sh\n    git clone https://github.com/yandex/mapkit-ios-demo.git\n    ```\n\n2. Execute the following command in your project's directory to install dependencies:\n    ```sh\n    pod install\n    ```\n\n3. MapKit SDK demo application and samples require __API key__. You can get a free MapKit __API key__ in the [Get the MapKit API Key](https://yandex.ru/dev/mapkit/doc/en/ios/generated/getting_started#key) documentation. The instruction on how to obtain NaviKit __API key__ is described in the [documentation](https://yandex.ru/dev/mapkit/doc/en/ios/generated/navigation/getting_started#get-key).\n\n4. Depending on the project you want to build, follow the steps in the following sections.\n\n### MapkitSamples\n\n1. Open the __project's__ build settings. Add the following user-defined setting with your __API key__ value in place of the `YOUR_API_KEY` placeholder:\n\n    ```pbxproj\n    MAPKIT_API_KEY = \"YOUR_API_KEY\";\n    ```\n\n2. Choose the desired target in Xcode, build and run.\n\n### MapKitDemo\n\n1. Open the [`AppDelegate.swift`](mapkit-demo/MapKitDemo/AppDelegate.swift) and edit the `MAPKIT_API_KEY` constant declaration, setting its value with your __API key__ in place of the `YOUR_API_KEY` placeholder:\n\n    ```swift\n    let MAPKIT_API_KEY = \"YOUR_API_KEY\"\n    ```\n\n    You can as well store this __API key__ in your project's build settings and `Info.plist` file.\n\n2. Build and run the MapKitDemo target in Xcode.\n\n### NaviKitDemo\n\n1. Open the project's build settings and edit the `MAPKIT_API_KEY` parameter, setting its value with your __API key__ in place of the `YOUR_MAPKIT_API_KEY` placeholder:\n\n    ```MAPKIT_API_KEY = YOUR_MAPKIT_API_KEY;```\n\n    You can as well store this __API key__ in your `Info.plist` file.\n\n2. Build and run the NaviKitDemo target in Xcode.\n\n## Support\n\nIf you have problems or suggestions while using MapKit or NaviKit SDK, visit the [contact](https://yandex.ru/dev/mapkit/doc/en/feedback/) page.\n\n## Sample overview\n\n| [MapWithPlacemark](mapkit-samples/MapWithPlacemark) \u003cbr\u003eDemonstrates how to create a MapKit map, move\u003cbr\u003eit, and display custom tappable placemarks. | [MapObjects](mapkit-samples/MapObjects) \u003cbr\u003eHow to display different objects on the map, including:\u003cbr\u003eimages, geometries, and clusterized collections. |\n|:-|:-|\n| ![](_assets/map_with_placemark_demo.gif) | ![](_assets/map_objects_demo.gif) |\n\n| [MapInteraction](mapkit-samples/MapInteraction)\u003cbr\u003e About interacting with the MapKit map using \u003cbr\u003ecamera movements, tap actions, focus rect \u003cbr\u003e and focus point, and interactions with POIs. | [MapSearch](mapkit-samples/MapSearch) \u003cbr\u003eShows how to use Search and Geosuggest \u003cbr\u003efunctionality in the full MapKit SDK. |\n|:-|:-|\n| ![](_assets/map_interaction_demo.gif) | ![](_assets/map_search_demo.gif) |\n\n| [MapRouting](mapkit-samples/map-routing)\u003cbr\u003e Building routes using requested map points. |\n|:-|\n| ![](_assets/map_routing_demo.gif) |\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyandex%2Fmapkit-ios-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyandex%2Fmapkit-ios-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyandex%2Fmapkit-ios-demo/lists"}