Convert Map View

Description

Converts from one map view to another type of map view at a specified location to zoom and center for a bounding box, to a bounding box for a specified zoom and center, or to a bounding box for a specified scale and center.

HTTP GET URL Format

The following format is used for HTTP GET requests using the /zoomAndCenter.json endpoint, which returns a zoom and center given a bounding box:


HTTP GET /zoomAndCenter.rep?b=x1,y1,x2,y2,srs&w=width&h=height&[l=locale]/
			
The following format is used for HTTP GET requests using the /bbox.json endpoint, which returns a bounding box given a center and zoom or a center and scale:

HTTP GET /bbox.rep?w=width&h=height&c=x,y,srs&z=zoom&[l=locale]/
			
or

HTTP GET /bbox.rep?w=width&h=height&c=x,y,srs&s=scale&[l=locale]/
			

Parameters

For information on the parameter types listed below, see Request URL Data Types.

Parameter Type Required Description
rep String yes The representation to be returned. Supported representation is JSON.
w=width Integer yes Width of the image in pixels
h=height Integer yes Height of the image in pixels
b=x1, y1, x2, y2, srs Double, Double, Double, Double, String y The bounding box that defines the entire view in real world coordinates using opposing x, y corner positions and the srs name (spatial reference system).
c=x, y, srs Double, Double, String yes The center of the view in geographic coordinates consisting of a x, y position and the srs name (spatial reference system).
z=zoom Integer, String yes The zoom, or distance across the view in linear units. The zoom is represented by a string with a number followed by one or more spaces followed by a linear unit abbreviation (for example, mi, km, m).
s=scale Integer yes The map view will be zoomed to the specified scale. The scale value is used to compare map and real world distance values. For example, if a value of 1000 is specified, the map scale is 1:1000 (1 map unit is equal to 1000 real world units).
l=locale String no The locale in which to return the map information. Uses the Java Locale format consisting of an ISO two letter language code and an ISO two letter country code. If not specified then assumes server default.

Returns

Returns a JSON object in the specified format.

Examples

Example 1

Transform the bounding box -40,-40,50,50 in popular visualization to a zoom and center that fits into an image 300 by 200:
http://hostname:port/rest/Spatial/MappingService/zoomAndCenter.json?b=-40,-40,50,50,epsg:3857&w=300&h=200
This returns a JSON object with a zoom and center:
{"zoom":{"uom":"METER","value":135.22613065326632},
"center":{
	"type":"Point",
	"coordinates":[5,5],
	"crs":{
		"type":"name",
		"properties":{"name":"epsg:3857"}
		}
	}
} 

Example 2

Transform the zoom and center in popular visualization to a bbox that fits into an image 300 by 200
http://hostname:port/rest/Spatial/MappingService/bbox.json?w=300&h=200&c=327630.72,613718.44,epsg:3857&z=176000%20m
This returns a bounding box given a zoom and center:
{"bbox":[239630.72,555149.88,415630.72,672287],
"crs":{
	"type":"name",
	"properties":{"name":"epsg:3857"}
	}
}