Google Static Map Url Builder
Utility for creating Google static maps url with a few simple options.
##Synopsis Sometimes, we need to present a grid screen with some google maps as thumbnails, but, for android apps, you need to include google play services, and use google maps api for loading MapFragment
instances, specifically using lite mode.
For a simpler approach, you can use the Google Static Maps API for construct such image map urls using some parameters.
With this library, you can apply for the second note, yeah, you can build static maps image urls, using options like latitude, longitude, zoom, image width and height, and adding markers to the map.
It uses the Fluent Builder pattern, making this process as simple as possible.
##Usage Add dependency.
(Gradle)
dependencies {
compile 'com.github.marlonlom:staticmaps-builder:1.0.0'
}
(Maven)
<dependency>
<groupId>com.github.marlonlom</groupId>
<artifactId>staticmaps-builder</artifactId>
<version>1.0.0</version>
</dependency>
This repository contains the sample module, you can check it out.
For creating static maps, use the StaticMapUrl
class
StaticMapUrl.create()
.centered(_latitude_, _longitude_)
.size(_imageWidth_, _imageHeight_)
.zoom(_zoom_)
.mark(_marker_)
.build();
The result is a string containing the url:
For creating markers and add it to the static maps, use the StaticMapMarker
class
StaticMapMarker.create(_color_, _latitude_, _longitude_).medium())
The color for the marker can be set as a 24-bit color (example: color=0xFFFFCC) or a predefined color using the folowwing set (black, brown, green, purple, yellow, blue, gray, orange, red, white).
The size of the marker is important, there are three methods, that must be used after create()
method: small()
, medium()
, tiny()
###Demo
Check the Demo here.
##Spread the word
If you like this library, please tell others about it
- Follow me on Twitter: @Marlonlom
- Contact me on LinkedIn: Marlonlom
###License
Copyright 2016 marlonlom
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.