Aller au contenu principal

OsmAnd API, SDK - Exemples

Si vous souhaitez utiliser OsmAnd comme bibliothèque pour votre application, vous pourriez envisager de l'utiliser via SDK ou via API. Actuellement, ces options ne sont disponibles que pour Android.

Il existe 2 façons principales de réutiliser la puissance d'OsmAnd dans votre application :

  • Android OsmAnd AIDL API
  • Android OsmAnd Full Library SDK

Tout le code des 2 exemples est disponible dans un seul dépôt.

Exemples SDK​

Voici la liste des exemples d'utilisation du SDK dans votre produit.

Carte simple - comment ajouter la carte Ă  une application simple.

Android OsmAnd AIDL API​

Le concept principal derrière cette approche est que l'application cible communique avec OsmAnd via AIDL ou l'API intents. OsmAnd dispose d'une grande variété de méthodes prises en charge par l'interface AIDL. Plusieurs applications ont été construites en utilisant cette approche et le concept principal est que l'application contient plusieurs écrans et un bouton « Aller à la carte ». En arrière-plan, l'application reconfigure complètement OsmAnd et fournit un rappel pour les opérations principales telles que la navigation, l'acquisition de la position GPS, et inclut également des éléments d'interface utilisateur tels que des widgets / boutons de tiroir, afin que l'utilisateur puisse naviguer de la carte vers l'API cible.

La liste des API est assez longue et vous pouvez vous familiariser avec elle dans l'application de démonstration.

Avantages

  • Pas de problèmes de licence - disponible pour tous les usages possibles
  • Toujours pris en charge, versionnĂ© et maintenu par l'Ă©quipe OsmAnd
  • L'intĂ©gration la plus simple nĂ©cessite le moins de lignes de code
  • Toujours ne pas mĂ©langer la logique OsmAnd et la logique mĂ©tier de l'application
  • Taille la plus petite (2 Mo)

Inconvénients

  • NĂ©cessite que l'application OsmAnd soit installĂ©e Ă  cĂ´tĂ© de votre application
  • Nombre limitĂ© de mĂ©thodes par rapport Ă  l'approche Full Library SDK
  • CapacitĂ©s de personnalisation limitĂ©es, bien qu'il puisse avoir un logo personnalisĂ©, des profils personnalisĂ©s, des styles de carte, etc. dans l'application OsmAnd
  • Pas possible de passer du code et des Ă©lĂ©ments d'interface utilisateur Ă  OsmAnd, donc toute interaction ne peut se faire qu'en basculant entre les Ă©crans des applications et les rappels

Veuillez consulter l'exemple sur le dépôt Github.

Android OsmAnd Full Library SDK​

La bibliothèque complète OsmAnd réutilise OsmAnd complet comme une bibliothèque. En gros, tout le code / tous les fragments d'interface utilisateur font partie de cette bibliothèque, ce qui donne la liberté d'utiliser ce qui est déjà présent dans OsmAnd, mais nécessite une bonne compréhension de la manière dont il est possible de combiner plusieurs couches / services.

Avantages

  • Pas besoin d'installer OsmAnd / OsmAnd+
  • Toutes les fonctions / mĂ©thodes possibles d'OsmAnd sont disponibles pour ĂŞtre rĂ©utilisĂ©es
  • Ne nĂ©cessite pas beaucoup de code propre pour construire une application riche

Inconvénients

  • Pas de documentation complète
  • Licence de code stricte, exactement la mĂŞme que le code OsmAnd lui-mĂŞme
  • L'API qui utilise les serveurs OsmAnd nĂ©cessite un consentement direct de l'Ă©quipe OsmAnd
  • L'API n'est pas stable (car ce n'est pas une API, c'est une bibliothèque interne en gros)
  • Taille 70-150 Mo (possible de rĂ©duire en supprimant la carte de base mondiale 20 Mo). D'autres manipulations de taille peuvent ĂŞtre effectuĂ©es en fonction de l'intention de l'application cible.

Veuillez consulter l'exemple sur le dépôt Github. Application de démonstration OsmAnd-map-sample.apk.

Licence​

Vous pourriez vouloir vérifier à nouveau la licence d'OsmAnd et la version complète.