{"id":13992369,"url":"https://github.com/googlemaps-samples/maps-sdk-for-ios-samples","last_synced_at":"2025-05-15T20:06:07.425Z","repository":{"id":12483326,"uuid":"68779363","full_name":"googlemaps-samples/maps-sdk-for-ios-samples","owner":"googlemaps-samples","description":"Samples for the Google Maps and Places SDKs for iOS","archived":false,"fork":false,"pushed_at":"2024-10-29T12:45:41.000Z","size":2601,"stargazers_count":294,"open_issues_count":10,"forks_count":164,"subscribers_count":31,"default_branch":"main","last_synced_at":"2024-10-29T15:14:41.605Z","etag":null,"topics":["google-maps","google-places","ios-sample","maps-sdk","objective-c","places-sdk","samples","swift"],"latest_commit_sha":null,"homepage":"https://developers.google.com/maps/documentation/ios-sdk/","language":"Objective-C","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/googlemaps-samples.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-21T04:13:12.000Z","updated_at":"2024-10-27T04:35:05.000Z","dependencies_parsed_at":"2024-04-18T13:58:14.334Z","dependency_job_id":"05506203-cec0-47da-a6c3-dca412fd2ed3","html_url":"https://github.com/googlemaps-samples/maps-sdk-for-ios-samples","commit_stats":null,"previous_names":["googlemaps-samples/maps-sdk-for-ios-samples","googlemaps/maps-sdk-for-ios-samples"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googlemaps-samples%2Fmaps-sdk-for-ios-samples","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googlemaps-samples%2Fmaps-sdk-for-ios-samples/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googlemaps-samples%2Fmaps-sdk-for-ios-samples/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googlemaps-samples%2Fmaps-sdk-for-ios-samples/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/googlemaps-samples","download_url":"https://codeload.github.com/googlemaps-samples/maps-sdk-for-ios-samples/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254414499,"owners_count":22067272,"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":["google-maps","google-places","ios-sample","maps-sdk","objective-c","places-sdk","samples","swift"],"created_at":"2024-08-09T14:01:57.919Z","updated_at":"2025-05-15T20:06:02.386Z","avatar_url":"https://github.com/googlemaps-samples.png","language":"Objective-C","readme":"[![Build](https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/actions/workflows/build.yml/badge.svg)](https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/actions/workflows/build.yml)\n\n![Contributors](https://img.shields.io/github/contributors/googlemaps-samples/maps-sdk-for-ios-samples?color=green)\n[![License](https://img.shields.io/github/license/googlemaps-samples/maps-sdk-for-ios-samples?color=blue)][license]\n[![StackOverflow](https://img.shields.io/stackexchange/stackoverflow/t/google-maps?color=orange\u0026label=google-maps\u0026logo=stackoverflow)](https://stackoverflow.com/questions/tagged/google-maps)\n[![Discord](https://img.shields.io/discord/676948200904589322?color=6A7EC2\u0026logo=discord\u0026logoColor=ffffff)][Discord server]\n\n# Google Maps SDK for iOS, Google Places SDK for iOS, and Google Navigation SDK for iOS sample code\n\n## Description\n\nThis repository provides one or more samples demonstrating use of various **iOS SDKs** in the Google Maps Platform.\n\n## Samples in this repo\n\nThis repository contains sample code for use with the\n\n- [Google Maps SDK for iOS][ios-sdk]\n- [Google Places SDK for iOS](https://developers.google.com/maps/documentation/places/ios-sdk), and\n- [Google Navigation SDK for iOS](https://developers.google.com/maps/documentation/navigation/ios-sdk)\n\n## Requirements\n\nTo run the samples, you will need:\n\n- To [sign up with Google Maps Platform]\n- A Google Maps Platform [project] with the relevant SDK enabled\n- An [API key] associated with the project above ... follow the [API key instructions] if you're new to the process\n- Swift or Objective-C\n- Xcode 15+\n- (Deployment target of) iOS 15+\n\n## GoogleMaps\n\nThe `GoogleMaps` and `GoogleMaps-Swift` sub-directory contains the sample code that is downloaded\nwhen you run `pod try GoogleMaps`. To use this project:\n\nFor Objective-C samples:\n\n```\n$ cd GoogleMaps\n$ pod install\n$ open GoogleMapsDemos.xcworkspace\n```\n\nFor Swift (UIKit) samples:\n\n```\n$ cd GoogleMaps-Swift\n$ pod install\n$ open GoogleMapsSwiftDemos.xcworkspace\n```\n\nAdd your API Key to `GoogleMapsDemos/SDKDemoAPIKey.h`.\n\n## GoogleMaps-SwiftUI\n\nThe `GoogleMaps-SwiftUI` sub-directory contains sample code demonstrating how to integrate Google Maps SDK with SwiftUI applications. It provides a modern SwiftUI wrapper around `GMSMapView` with a declarative API for common map configurations and interactions. To use this project:\n\n```\n$ cd GoogleMaps-SwiftUI\n$ open GoogleMaps-SwiftUI.xcodeproj\n```\n\nThis project uses Swift Package Manager and requires the [GoogleMaps package](https://github.com/googlemaps/ios-maps-sdk). The sample code demonstrates best practices for integrating Google Maps into SwiftUI-based iOS applications.\n\n## GooglePlaces\n\nThe `GooglePlaces` and `GooglePlaces-Swift` sub-directory contains the sample code that is downloaded\nwhen you run `pod try GooglePlaces`. To use this project:\n\n```\n$ cd GooglePlaces\n$ pod install\n$ open GooglePlacesDemos.xcworkspace\n```\n\nFor Swift samples:\n\n```\n$ cd GooglePlaces-Swift\n$ pod install\n$ open GooglePlacesSwiftDemos.xcworkspace\n```\n\nAdd your API Key to `GooglePlacesDemos/SDKDemoAPIKey.h`.\n\n## GoogleNavigation\n\nThe `GoogleNavigation` and `GoogleNavigation-Swift` sub-directory contains the sample code that is downloaded\nwhen you run `pod try GoogleNavigation`. To use this project:\n\n```\n$ cd GoogleNavigation\n$ pod install\n$ open GoogleNavigationDemos.xcworkspace\n```\n\nFor Swift samples:\n\n```\n$ cd GoogleNavigation-Swift\n$ pod install\n$ open GoogleNavigationSwiftDemos.xcworkspace\n```\n\nAdd your API Key to `GoogleNavigationDemos/SDKDemoAPIKey.h`.\n\n## MapsAndPlacesDemo\n\nThis demo application looks to bridge some of the features found in the GooglePlaces and GoogleMaps demo applications as well as utilize some of the ways the two API's can work together.\nClick this [link](https://www.youtube.com/watch?v=u4Ih8EWqZio) to watch a video demonstration.\n\n- If you are emulating this from you Mac, please make sure to set the emulated phone's location (otherwise, location features will not work)\n- A [Google Cloud Platform API key](https://developers.google.com/maps/documentation/ios-sdk/start#get-key) with Maps SDK for iOS and Places SDK for iOS enabled\n- A light and dark themed map, which can be created [here](https://console.cloud.google.com/google/maps-apis/client-styles?project=verdant-medium-278819\u0026folder=\u0026organizationId=) (make sure you sign in first)\n- If you want a different data set, ensure that it follows the correct formatting (and is also a JSON file) like the one provided (the data set provided can be found in dataset.json)\n\n### Installation\n1. Make sure you are in the right folder (MapsAndPlacesDemo)\n2. Run `pod install`\n3. Open `MapsAndPlacesDemo.xcworkspace`\n4. Drag the data set (dataset.json) into the Xcode file explorer (left pane)\n\n## Tutorials\n\nThe `tutorials` sub-directory contains sample code that accompanies tutorials in the developer\ndocumentation, such as\n[Adding a Map with a Marker](https://developers.google.com/maps/documentation/ios-sdk/map-with-marker),\nand more. Follow the tutorials for a quick guide to using the SDK.\n\n## Snippets\n\nThe `snippets` sub-directory contains code snippets that can be found in the developer documentation site.\n\n## Contributing\n\nExternal contributions are not accepted for this repository. See [contributing guide] for more info.\n\n## Terms of Service\n\nThis sample uses Google Maps Platform services. Use of Google Maps Platform services through this sample is subject to the Google Maps Platform [Terms of Service].\n\nThis sample is not a Google Maps Platform Core Service. Therefore, the Google Maps Platform Terms of Service (e.g. Technical Support Services, Service Level Agreements, and Deprecation Policy) do not apply to the code in this sample.\n\n## Support\n\nThis sample is offered via an open source [license]. It is not governed by the Google Maps Platform Support [Technical Support Services Guidelines], the [SLA], or the [Deprecation Policy]. However, any Google Maps Platform services used by the sample remain subject to the Google Maps Platform Terms of Service.\n\nIf you find a bug, or have a feature request, please [file an issue] on GitHub. If you would like to get answers to technical questions from other Google Maps Platform developers, ask through one of our [developer community channels]. If you'd like to contribute, please check the [contributing guide].\n\nIf you find a bug or have a feature request related to one of the SDKs, you can file an issue at their respective pages:\n\n- [Maps SDK for iOS Issue Tracker](https://developers.google.com/maps/documentation/ios-sdk/support#issue-tracker)\n- [Places SDK for iOS Issue Tracker](https://developers.google.com/maps/documentation/places/ios-sdk/support#issue-tracker)\n- [Navigation SDK for iOS Issue Tracker](https://developers.google.com/maps/documentation/navigation/ios-sdk/support#issue-tracker)\n\nYou can also discuss these samples on our [Discord server].\n\n[ios-sdk]: https://developers.google.com/maps/documentation/ios-sdk\n[API key]: https://developers.google.com/maps/documentation/ios-sdk/get-api-key\n[API key instructions]: https://developers.google.com/maps/documentation/ios-sdk/config#get-key\n\n[code of conduct]: ?tab=coc-ov-file#readme\n[contributing guide]: CONTRIBUTING.md\n[Deprecation Policy]: https://cloud.google.com/maps-platform/terms\n[developer community channels]: https://developers.google.com/maps/developer-community\n[Discord server]: https://discord.gg/hYsWbmk\n[file an issue]: https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/issues/new/choose\n[license]: LICENSE\n[pull request]: https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/compare\n[project]: https://developers.google.com/maps/documentation/ios-sdk/cloud-setup#enabling-apis\n[Sign up with Google Maps Platform]: https://console.cloud.google.com/google/maps-apis/start\n[SLA]: https://cloud.google.com/maps-platform/terms/sla\n[Technical Support Services Guidelines]: https://cloud.google.com/maps-platform/terms/tssg\n[Terms of Service]: https://cloud.google.com/maps-platform/terms\n","funding_links":[],"categories":["Objective-C"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgooglemaps-samples%2Fmaps-sdk-for-ios-samples","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgooglemaps-samples%2Fmaps-sdk-for-ios-samples","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgooglemaps-samples%2Fmaps-sdk-for-ios-samples/lists"}