This example app showcases the eeGeo SDK, a cross-platform, OpenGL-based library for displaying beautiful and engaging 3D maps.
- Detailed 3D coverage for the whole of Canada, Great Britain, the United States, and more
- Indoor maps in full 3D
- Flexible themes, allowing you to change the style of your map
- Customisable pins and markers
- Support for custom 3D models and animation
- Compatibility with iOS, Android, Windows, and OS X
- Continuous deployment, meaning you get the latest features as they're developed
Download our app, Recce, on Google Play or the App Store to see what the eeGeo SDK can do. Or read on to build the app yourself.
If you have any questions, bug reports, or feature requests, feel free to submit to the issue tracker for this repository.
This example app demonstrates the use of the eeGeo SDK to display beautiful 3D maps on iOS, Android, and Windows PCs. It can be used as the basis for your own app, or can be used as a reference when integrating eeGeo's maps into an existing app.
The eeGeo SDK is distributed as a C++ static library with headers. Most of this example application is also written in C++ and shared between platforms to reduce code duplication.
This section will walk you through the process of getting up and running quickly on each platform.
- Clone this repo:
git clone https://github.com/eegeo/eegeo-example-app - Obtain an eeGeo API key and place it in the configuration file for the platform you are building:
- Choose a platform from the table below to see detailed instructions for building the app.
| Platform | Languages | UI |
|---|---|---|
| Getting started on Android | C++, Java | Android UI |
| Getting started on iOS | C++, Objective-C | Cocoa Touch |
| Getting started on Windows | C++, C# | WPF |
In order to use the eeGeo 3D Maps SDK, you must sign up for a free developer account at https://www.eegeo.com/developers. After signing up, you'll be able to create an API key for your apps.
To run this example app, you must place the API key in the application configuration file for each of the platforms you are building, specifying the value of "EegeoApiKey":
If you are creating a new app, or integrating eeGeo 3D Maps into an existing app, the API key should be passed as the first argument to the constructor of EegeoWorld.
This app uses third-party search service providers to allow users to search for places like cafés, restaurants, and bars and have the results show up on the map. To enable this, you will to supply the credentials for those services.
- Obtain Yelp credentials to enable Yelp search results in the app. Place them in the application config file appropriate for the platform you are building:
- Obtain a GeoNames username to enable GeoNames search results in the app. Place it in the application config file appropriate for the platform you are building:
The eeGeo Example App demonstrates a variety of SDK features and is a good starting point to learn how the SDK works.
See here to learn more about what the eeGeo SDK has to offer.
See the eeGeo API reference for documentation on the individual SDK types.
The eeGeo 3D Maps Example App is released under the Simplified BSD License. See the LICENSE.md file for details.