+ def self.from_s(s)
+ BoundingBox.new(*s.split(/,/)) if s.count(",") == 3
+ end
+
+ def self.from_bbox_params(params)
+ bbox_array = params[:bbox].split(",") if params[:bbox] && params[:bbox].count(",") == 3
+ from_bbox_array(bbox_array)
+ end
+
+ def self.from_lon_lat_params(params)
+ bbox_array = [params[:minlon], params[:minlat], params[:maxlon], params[:maxlat]] if params[:minlon] && params[:minlat] && params[:maxlon] && params[:maxlat]
+ from_bbox_array(bbox_array)
+ end
+
+ def self.from_lrbt_params(params)
+ bbox_array = [params[:l], params[:b], params[:r], params[:t]] if params[:l] && params[:b] && params[:t] && params[:t]
+ from_bbox_array(bbox_array)
+ end
+
+ def expand!(bbox, margin = 0)
+ update!(bbox) unless complete?
+ # only try to expand the bbox if there is a value for every coordinate
+ # which there will be from the previous line as long as array does not contain a nil
+ if bbox.complete?
+ if bbox.min_lon < min_lon
+ @min_lon = [-SCALED_LON_LIMIT,
+ bbox.min_lon + margin * (min_lon - max_lon)].max
+ end
+ if bbox.min_lat < min_lat
+ @min_lat = [-SCALED_LAT_LIMIT,
+ bbox.min_lat + margin * (min_lat - max_lat)].max
+ end
+ if bbox.max_lon > max_lon
+ @max_lon = [+SCALED_LON_LIMIT,
+ bbox.max_lon + margin * (max_lon - min_lon)].min
+ end
+ if bbox.max_lat > max_lat
+ @max_lat = [+SCALED_LAT_LIMIT,
+ bbox.max_lat + margin * (max_lat - min_lat)].min
+ end
+ end
+ self
+ end
+
+ def check_boundaries
+ # check the bbox is sane
+ raise OSM::APIBadBoundingBox, "The minimum longitude must be less than the maximum longitude, but it wasn't" if min_lon > max_lon
+ raise OSM::APIBadBoundingBox, "The minimum latitude must be less than the maximum latitude, but it wasn't" if min_lat > max_lat
+ if min_lon < -LON_LIMIT || min_lat < -LAT_LIMIT || max_lon > +LON_LIMIT || max_lat > +LAT_LIMIT
+ raise OSM::APIBadBoundingBox, "The latitudes must be between #{-LAT_LIMIT} and #{LAT_LIMIT}," \
+ " and longitudes between #{-LON_LIMIT} and #{LON_LIMIT}"
+ end
+ self
+ end
+
+ def check_size(max_area = MAX_REQUEST_AREA)
+ # check the bbox isn't too large
+ if area > max_area
+ raise OSM::APIBadBoundingBox, "The maximum bbox size is " + max_area.to_s +
+ ", and your request was too large. Either request a smaller area, or use planet.osm"
+ end
+ self
+ end
+
+ ##
+ # returns area of the bbox as a rough comparative quantity
+ def area
+ if complete?
+ (max_lon - min_lon) * (max_lat - min_lat)
+ else
+ 0
+ end
+ end
+
+ def complete?
+ !to_a.include?(nil)