usage.md

J4JMapLibrary: Usage

• determining which map service you want to use and setting up an account with it, if required
• creating a Projection instance for the service
• authenticating the projection
• using ProjectionFactory to get a Projection instance
• how imagery is returned
  • The MapRegion Object
  • The MapTile Object
  • loading image data into a MapTile object
• Other topics
  • details on the Projection classes
  • writing your own projection class
  • a note on the test routines

Using the library involves the following steps:

• creating an instance of the projection class supporting the mapping service you want to use
• authenticating the projection instance
• defining a MapRegion (which describes the display area you're interested in and how it relates to the underlying map service's map at a given scale)
• loading the MapRegion with image data, or defining a MapTile within the MapRegion and loading it with image data. This is done using one of the image retrieval methods defined for the projection.