Image thumbnail retrieval implemented

[OmarMuhammedAli]

Related Issue(s) #17

Proposed Changes

• Create image_thumbnail driver function.
• Create get_imgae_thumbnail controller to hold business logic
• Create InvalidImageResolution to handle unsupported input resolution exceptions
• Create InvalidImageKey to handle invalid input image ID/key exceptions.

Example Usage

        >>> import mapillary as mly
        >>> mly.set_access_token('MLY|XXX')
        >>> mly.image_thumbnail(
        ...     image_id='IMAGE_ID_HERE', resolution='DESIRED_RESOLUTION'
        ... )

[Rubix982]

Just some typos. Other than that, it looks fantastic!

Approving this PR. For the typos, it's not really a big deal. You can make a commit and self merge the branch if you like, or just leave it, I can solve it in my coming PR as well.

Great job. :D

[Rubix982]

Awesome! Merging.

[cbeddow]

@OmarMuhammedAli will this be exposed to the user? Would be helpful to provide the hint in case they otherwise do not know, so if they enter 320 it can mention the hint in the error message maybe?

[OmarMuhammedAli]

@cbeddow Yes, this hint is exposed to the user. The controller first checks for the given resolution, and if it's not one of the supported ones, it doesn't go on with requesting the thumbnail from the API, and it raises an exception that shows the error message alongside the hint.

[cbeddow]

We should default to 1024 if it is unspecified

[OmarMuhammedAli]

Yes, that's already implemented. I'll update the docstring to reflect that as well!