Initiated Nextbillion.ai Maps Flutter SDK

Author: NBAIDan

.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+name: Nextbillion Maps Flutter CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+
+      - name: Setup Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: "3.22.0"
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Run analyzer
+        run: flutter analyze lib
+
+      - name: Run tests with coverage
+        run: |
+          flutter test --coverage          
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v2
+        with:
+          files: coverage/lcov.info
+          flags: unittests
+          name: codecov-report
+          fail_ci_if_error: true
+          token: ${{ secrets.CODECOV_TOKEN }}

.gitignore

@@ -0,0 +1,121 @@
+# Miscellaneous
+*.class
+*.lock
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+.fvm/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+build/
+
+# Visual Studio Code related
+.classpath
+.project
+.settings/
+.vscode/
+
+# Flutter repo-specific
+/bin/cache/
+/bin/mingit/
+/dev/benchmarks/mega_gallery/
+/dev/bots/.recipe_deps
+/dev/bots/android_tools/
+/dev/docs/doc/
+/dev/docs/flutter.docs.zip
+/dev/docs/lib/
+/dev/docs/pubspec.yaml
+/dev/integration_tests/**/xcuserdata
+/dev/integration_tests/**/Pods
+/packages/flutter/coverage/
+version
+
+# packages file containing multi-root paths
+.packages.generated
+
+# Flutter/Dart/Pub related
+**/doc/api/
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.packages
+.pub-cache/
+.pub/
+flutter_*.png
+linked_*.ds
+unlinked.ds
+unlinked_spec.ds
+
+# Android related
+**/android/**/gradle-wrapper.jar
+**/android/.gradle
+**/android/captures/
+**/android/gradlew
+**/android/gradlew.bat
+**/android/local.properties
+**/android/**/GeneratedPluginRegistrant.java
+**/android/key.properties
+*.jks
+
+# iOS/XCode related
+**/ios/**/*.mode1v3
+**/ios/**/*.mode2v3
+**/ios/**/*.moved-aside
+**/ios/**/*.pbxuser
+**/ios/**/*.perspectivev3
+**/ios/**/*sync/
+**/ios/**/.sconsign.dblite
+**/ios/**/.tags*
+**/ios/**/.vagrant/
+**/ios/**/DerivedData/
+**/ios/**/Icon?
+**/ios/**/Pods/
+**/ios/**/.symlinks/
+**/ios/**/profile
+**/ios/**/xcuserdata
+**/ios/.generated/
+**/ios/Flutter/App.framework
+**/ios/Flutter/Flutter.framework
+**/ios/Flutter/Flutter.podspec
+**/ios/Flutter/Generated.xcconfig
+**/ios/Flutter/app.flx
+**/ios/Flutter/app.zip
+**/ios/Flutter/flutter_assets/
+**/ios/Flutter/flutter_export_environment.sh
+**/ios/ServiceDefinitions.json
+**/ios/Runner/GeneratedPluginRegistrant.*
+
+# macOS
+**/macos/Flutter/GeneratedPluginRegistrant.swift
+**/macos/Flutter/Flutter-Debug.xcconfig
+**/macos/Flutter/Flutter-Release.xcconfig
+**/macos/Flutter/Flutter-Profile.xcconfig
+__MACOSX/
+
+# Coverage
+coverage/
+
+# Binaries
+google-java-format-1.13.0-all-deps.jar
+swiftformat
+
+# Symbols
+app.*.symbols
+
+# Exceptions to above rules.
+!**/ios/**/default.mode1v3
+!**/ios/**/default.mode2v3
+!**/ios/**/default.pbxuser
+!**/ios/**/default.perspectivev3
+!/packages/flutter_tools/test/data/dart_dependencies_test/**/.packages
+!/dev/ci/**/Gemfile.lock
+

CHANGELOG.md

@@ -0,0 +1,106 @@
+## v1.2.0, Dec 16, 2024
+* Adapting to Android Gradle Plugin 8.0 Without Using the AGP Upgrading Assistant
+
+## v1.1.0, Nov 28, 2024
+* Update Android NB Maps SDK to 1.1.5 
+* Adapt to Android Gradle Plugin 8.0
+* Upgrade the compile SDK version to 34 to support Flutter SDK 3.24.0+
+
+## v1.0.0, Sept 5, 2024
+* Pinned `NextBillionMap` dependency to version `1.1.5`.
+
+## v0.4.3, Sep 4, 2024
+* Update Android NB Maps SDK to 1.1.4 and Update iOS NB Maps framework to 1.1.5
+  * Modify user agent for Android and iOS
+  * Add cross-platform info into the native user agent
+
+## v0.4.2, June 6, 2024
+* Update Android NB Maps SDK to 1.1.3 and Update iOS NB Maps framework to 1.1.4
+
+## v0.4.1, June 5, 2024
+* Add setUserId method to NextBillion
+* Add getUserId method to NextBillion
+* Add getNbId method to NextBillion
+## v0.4.0, May 29, 2024
+* Remove state check exception when calling methods of NextbillionMapController after the controller is disposed
+
+## v0.3.5, May 7, 2024
+* Add result for NextBillion methods
+
+## v0.3.4, May 7, 2024
+* Add await for some methods in controller
+* Support obtaining the disposed status from the controller
+
+## v0.3.2, Apr 29, 2024
+* Update Android NB Maps SDK to 1.1.0
+* Update iOS NB Maps framework to 1.1.0
+
+## v0.3.1, Apr 24, 2024
+* Throw an exception when calling methods of NextbillionMapController after the controller is disposed
+
+## v0.3.0, Nov 8, 2023
+* Update Android NB Maps SDK to 1.0.3
+
+## v0.2.0, Sept 26, 2023
+* Update iOS NB Maps framework to 1.0.3
+* Update Android NB Maps SDK to 1.0.2
+* Support to fit camera into bounds with multi points
+
+## v0.1.6, Sept 15, 2023
+* Fix the animateCamera issue
+  * When calling controller.animateCamera() within onStyleLoadedCallback 
+
+## v0.1.5, Aug 17, 2023
+* Update Android NB Maps SDK to 1.0.0
+* Update the default map style
+
+## v0.1.4, Aug 16, 2023
+* Update iOS NB Maps framework to 1.0.2
+* Support to change the base url of map style url
+* Update the default map style
+
+## v0.1.0, July 20, 2023
+* Display MapView
+  * Camera position
+  * Map Click Callback
+  * OnMapLongClickCallback
+  * MapView Created callback
+  * Map Style loaded callback
+* Map Options
+  * Map Style String
+  * Enable Map Compass
+  * Enable zoom/scroll/tilt/rotate gestures
+  * Enable User Location
+  * Config Location Tracking Mode
+  * Config Location Render Mode
+* Location Component
+  * Tracking Current location
+  * Get Current location
+  * OnLocationUpdate Callback
+* Camera API
+  * Animate Camera
+  * Move Camera
+  * OnCameraTrackingDismissedCallback
+  * OnCameraTrackingChangedCallback
+  * OnCameraIdleCallback
+* Annotations View
+  * Symbol annotation
+  * Line annotation
+  * Fill annotation
+  * Circle annotation
+  * Add Asset Image Symbol
+* Query Features
+* Customize source & layers
+  * GeoJson Source
+  * Image Source
+  * Raster Source
+  * Vector Source
+  * Hillshade Layer
+  * Fill Layer
+  * Line Layer
+  * Circle Layer
+  * Symbol Layer
+  * Raster Layer
+
+## v0.1.4, August 16, 2023
+* Update iOS native framework version from 1.0.1 to 1.0.2

LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) , NextBillion.ai
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials provided
+      with the distribution.
+    * Neither the name of copyright holder nor the names of its
+      contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.