Skip to main content

Twórz z OsmAnd

Przeczytaj Dokumentację techniczną, jak zintegrować się z OsmAnd.

Użyj OsmAnd API

OsmAnd API pozwala kontrolować zainstalowaną aplikację OsmAnd. Rozpoczęcie tworzenia aplikacji za pośrednictwem API jest łatwe i proste, a także może być osadzone w dowolnej aplikacji, bez wymagań licencyjnych aplikacji docelowej. Jedyną wadą jest to, że musisz mieć już zainstalowany OsmAnd.

Funkcje OsmAnd API:

  • Dodawanie ulubionych i znaczników do mapy
  • Nawigacja między lokalizacjami
  • Tworzenie notatek audio, wideo i zdjęć
  • Rozpoczynanie i zatrzymywanie nagrywania ścieżki GPX
  • Importowanie ścieżek GPX do OsmAnd i nawigowanie wzdłuż nich
  • Wiele innych funkcji jest już obecnych lub może zostać zaimplementowanych na żądanie

Rozpocznij tworzenie (API)

Możesz zbudować swój własny projekt w dowolny sposób. Integracja z OsmAnd API odbywa się za pomocą dwóch typów intencji: cichych lub widocznych. Cicha intencja nie utrzymuje OsmAnd otwartym, natomiast widoczna intencja przenosi OsmAnd do określonego ekranu. Istnieją plany dodania komunikacji międzyprocesowej Androida w przyszłości. Proszę zapoznać się z kodem źródłowym projektu OsmAnd API.

🛠️ Przykłady

Przeglądaj kod źródłowy GitHub i zainstaluj demo z Google Play.

Przeczytaj Dokumentację techniczną, aby uzyskać więcej szczegółów.

Licencja (API)

Ponieważ nie ma bezpośredniego użycia kodu z podstawowego projektu OsmAnd, licencja jest inna dla OsmAnd API i dla projektu OsmAnd Core. Najprawdopodobniej aplikacje korzystające z OsmAnd API będą pisane od podstaw, a ta aplikacja dostarczona jako przykład w ogóle nie będzie używana. Dla OsmAnd API używana jest najmniej restrykcyjna licencja, licencja MIT.

https://github.com/osmandapp/osmand-api-demo/blob/master/LICENSE.md

Użyj OsmAnd SDK

OsmAnd Sample przedstawia możliwość zbudowania aplikacji na bazie rdzenia OsmAnd. OsmAnd udostępnia bibliotekę Java z wieloma wbudowanymi funkcjami. Proszę zapoznać się z kodem źródłowym. OsmAnd Sample nie jest przypadkiem użycia API, a LICENCJA OsmAnd Sample jest taka sama jak samej aplikacji OsmAnd. Zapewnia to możliwość pakowania i dystrybucji niezależnie od OsmAnd.

Rozpocznij tworzenie (SDK)

🛠️ Przykłady

Przeglądaj kod źródłowy GitHub i zainstaluj demo APK.

Przeczytaj dokumentację techniczną, aby uzyskać więcej szczegółów.

Licencja (SDK)

Licencja dla aplikacji OsmAnd jest dość obszerna. Istnieją 2 ważne rzeczy: OsmAnd używa kodu stron trzecich tylko z licencjami permisywnymi, takimi jak (LGPL, MIT, Apache), a sam kod OsmAnd, chroniony prawami autorskimi OsmAnd BV, jest rozpowszechniany na licencji GPLv2 z wyjątkiem dystrybucji na rynkach Google Play bez pozwolenia. Zapewnia to możliwość budowania dowolnej aplikacji do użytku osobistego lub budowania aplikacji open source na licencji GPLv2 (ponieważ OsmAnd nie jest platformą, a cały kod zbudowany na rdzeniu musi być również licencjonowany jako GPL).

Jeśli chcesz zbudować aplikację do użytku wewnętrznego, skontaktuj się z business@osmand.net, w niektórych przypadkach udzielane są zwolnienia z kodu GPLv2 chronionego prawami autorskimi OsmAnd BV. W przypadku pozostałego kodu proszę dokładnie sprawdzić listę z LICENCJI, która składa się tylko z licencji permisywnych (LGPL, MIT, Apache).

W razie jakichkolwiek pytań, prosimy o kontakt z business@osmand.net. Chętnie również udzielimy pomocy od doświadczonych programistów OsmAnd w budowaniu aplikacji specjalnego przeznaczenia.

Skontaktuj się z nami w sprawie rozwoju

W przypadku, gdy nie jesteś pewien, który przypadek najbardziej Ci odpowiada lub chciałbyś poprosić o pomoc programistów, którzy mają doświadczenie w budowaniu aplikacji zintegrowanych z OsmAnd, prosimy o kontakt business@osmand.net!