Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mousebird-consulting-inc/WhirlyGlobe
WhirlyGlobe Development
https://github.com/mousebird-consulting-inc/WhirlyGlobe
android geodesy gis globe ios location mapping
Last synced: 7 days ago
JSON representation
WhirlyGlobe Development
- Host: GitHub
- URL: https://github.com/mousebird-consulting-inc/WhirlyGlobe
- Owner: mousebird-consulting-inc
- License: other
- Created: 2012-01-09T18:51:52.000Z (almost 13 years ago)
- Default Branch: main
- Last Pushed: 2024-02-22T20:03:55.000Z (10 months ago)
- Last Synced: 2024-05-23T10:13:06.472Z (7 months ago)
- Topics: android, geodesy, gis, globe, ios, location, mapping
- Language: C++
- Homepage:
- Size: 523 MB
- Stars: 823
- Watchers: 62
- Forks: 253
- Open Issues: 104
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - WhirlyGlobe-Maply - 3D globe and flat-map SDK for iOS. This toolkit has a large API for fine-grained control over the map or globe. It reads a wide variety of GIS data formats. (Maps / Other Hardware)
README
[](https://www.apache.org/licenses/LICENSE-2.0.html)
[](https://github.com/mousebird-consulting-inc/WhirlyGlobe/releases)
[](https://github.com/mousebird-consulting-inc/WhirlyGlobe/issues)
[](https://github.com/mousebird-consulting-inc/WhirlyGlobe/issues?q=is%3Aissue+is%3Aclosed)
[](https://github.com/mousebird-consulting-inc/WhirlyGlobe/pulls)
What is WhirlyGlobe-Maply?
---
WhirlyGlobe-Maply is a mapping toolkit with two parts, hence the dash. The WhirlyGlobe part is an interactive 3D globe. The Maply part is an interactive 2D map. There are separate view controllers (on iOS) for each, but otherwise they share 95% of their code.
This toolkit is used in [many apps](http://mousebird-consulting-inc.github.io/WhirlyGlobe/apps/apps.html) from big, complicated apps to even more smaller, simpler apps. Feel free to use it in yours.
WhirlyGlobe-Maply is available for both iOS and Android.
Getting Started
---
If you're new to WhirlyGlobe-Maply, please [read the main page](https://mousebird-consulting-inc.github.io/WhirlyGlobe/). See More Information below for useful links and resources.
There’s a tutorial for both iOS and Android:
- [Getting started with iOS](http://mousebird-consulting-inc.github.io/WhirlyGlobe/tutorial/ios/getting_started.html)
- [Getting started with Android](http://mousebird-consulting-inc.github.io/WhirlyGlobe/tutorial/android/getting-started.html)
Builds
---
[](https://app.bitrise.io/app/73efc488840cb3bf) | iOS Main
-: | :-
[](https://app.bitrise.io/app/36f069a6fbd58b11) | Android Main
This is the main branch of the WhirlyGlobe-Maply Component and API version 3.5. It should be easy to compile, as all the crazy dependencies are in submodules. You can also get a [precompiled version](https://mousebird-consulting-inc.github.io/WhirlyGlobe/builds/builds.html).
WhirlyGlobe-Maply uses a bunch of submodules, which you'll need to get. Like so:
```
git submodule init
git submodule update
```
Get comfortable. The data is contained in a submodule and it's large.
Once you get all this synced, try to build AutoTester. If it builds, you're good to go. Enjoy.
Want more detail? Go read the [Tutorials](http://mousebird-consulting-inc.github.io/WhirlyGlobe/tutorial/) on the WhirlyGlobe-Maply site.
Breaking Changes
---
If you're upgrading from 3.3, you will need to make some adjustments due to the switch to xcframework and modular headers:
- When embedding the framework as is done in AutoTester, Swift no longer automatically imports the module because it doesn't match the project name. You will need an additional `import WhirlyGlobe` at the top of Swift files using the API.
- If you're including header files from Obj-C++ code, you'll need to use the modular include style, `#import `, and using quoted includes will produce a compile error.
More Information
---
There's a [mailing list](http://eepurl.com/D30CD) for periodic announcements. Join!
Check out the [mousebird consulting blog](http://mousebirdconsulting.blogspot.com) for current progress.
Follow us on Twitter: [@whrlyglobemaply](https://twitter.com/whrlyglobemaply)
Email questions to: [email protected]