Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/googlemaps/ios-maps-sdk

Google Maps SDK for iOS
https://github.com/googlemaps/ios-maps-sdk

Last synced: 3 months ago
JSON representation

Google Maps SDK for iOS

Awesome Lists containing this project

README

        

# Google Maps SDK For iOS Swift package

## Description

This repository contains the Swift package for the
[Maps SDK for iOS](https://developers.google.com/maps/documentation/ios-sdk).
For additional methods of installing the Maps SDK for iOS including CocoaPods,
see the Maps SDK for iOS
[documentation](https://developers.google.com/maps/documentation/ios-sdk/config).

## Requirements

- [Xcode](https://developer.apple.com/xcode/) version 15.0 or later
- An app targeting iOS 15 or later
- A Google Maps Platform
[project](https://developers.google.com/maps/documentation/ios-sdk/cloud-setup)
with the Maps SDK for iOS enabled.
- An
[API key](https://developers.google.com/maps/documentation/ios-sdk/get-api-key)
associated with the project above.

## Installation

1. Follow the instructions for
[adding package dependencies to your app in Xcode](https://developer.apple.com/documentation/xcode/adding-package-dependencies-to-your-app).

2. In the "Enter Package URL" field, enter this GitHub repository:

```
https://github.com/googlemaps/ios-maps-sdk
```

3. Select the
[version](https://developers.google.com/maps/documentation/ios-sdk/versions)
of the Maps SDK for iOS that you want to use. For new projects, we recommend
specifying the latest version and using the "Exact Version" option.

4. Follow the
[instructions](https://developers.google.com/maps/documentation/ios-sdk/config#get-key)
to add your API key to your app.

## Sample App

See samples demonstrating use of the Maps SDK for iOS on
[developers.google.com](https://developers.google.com/maps/documentation/ios-sdk/code-samples)
or on [GitHub](https://github.com/googlemaps-samples/maps-sdk-for-ios-samples).

## Documentation

Documentation for the Maps SDK for iOS is available as
[guides](https://developers.google.com/maps/documentation/ios-sdk/) and
[reference documentation](https://developers.google.com/maps/documentation/ios-sdk/reference).

## Contributing

External contributions are not accepted for this repository, per the
[Contributing guide](https://github.com/googlemaps/ios-maps-sdk/blob/main/CONTRIBUTING.md).

## Terms of Service

This package uses Google Maps Platform services, and any use of Google Maps
Platform is subject to the
[Terms of Service](https://cloud.google.com/maps-platform/terms).

## Support

This repository is offered via an open source license. It is not governed by the
Google Maps Platform Support
[Technical Support Services Guidelines](https://cloud.google.com/maps-platform/terms/tssg),
the [SLA](https://cloud.google.com/maps-platform/terms/sla), or the
[Deprecation Policy](https://cloud.google.com/maps-platform/terms) (however, any
Google Maps Platform services used by the library remain subject to the Google
Maps Platform Terms of Service).

This repository adheres to [semantic versioning](https://semver.org/) to
indicate when backwards-incompatible changes are introduced. Accordingly, while
the library is in version 0.x, backwards-incompatible changes may be introduced
at any time.

- For issues with the Maps SDK for iOS,
[file an issue](https://developers.google.com/maps/documentation/ios-sdk/support#issue-tracker)
on the Maps SDK for iOS issue tracker or
[open a support case](https://developers.google.com/maps/documentation/ios-sdk/support#contact-maps-support).
- If you find a bug with the Swift package, please
[file an issue](https://github.com/googlemaps/ios-maps-sdk/issues) 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](https://developers.google.com/maps/developer-community).
You can also discuss on the Google Maps Platform
[Discord server](https://discord.gg/hYsWbmk).