Class: OvertureMaps::Configuration

Inherits:
Object
  • Object
show all
Defined in:
lib/overture_maps/configuration.rb

Constant Summary collapse

DEFAULT_S3_HTTP_URL = 
"https://overturemaps-us-west-2.s3.us-west-2.amazonaws.com"
DEFAULT_S3_URI = 
"s3://overturemaps-us-west-2"
DEFAULT_S3_REGION = 
"us-west-2"

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Configuration

Returns a new instance of Configuration.



26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/overture_maps/configuration.rb', line 26

def initialize
  @release = nil
  @cache_dir = "tmp/overture"
  @s3_http_url = DEFAULT_S3_HTTP_URL
  @s3_uri = DEFAULT_S3_URI
  @s3_region = DEFAULT_S3_REGION
  @batch_size = 1000
  @timeout = 30
  @non_interactive = !ENV["OVERTURE_NON_INTERACTIVE"].to_s.empty?
  @duckdb_cli_path = ENV["OVERTURE_DUCKDB_CLI"]
  @logger = nil
  @api_auth = nil
  @api_default_limit = 100
  @api_max_limit = 1000
  @tile_feature_limit = 20_000
end

Instance Attribute Details

#api_auth ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def api_auth
  @api_auth
end

#api_default_limit ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def api_default_limit
  @api_default_limit
end

#api_max_limit ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def api_max_limit
  @api_max_limit
end

#batch_size ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def batch_size
  @batch_size
end

#cache_dir ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def cache_dir
  @cache_dir
end

#duckdb_cli_path ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def duckdb_cli_path
  @duckdb_cli_path
end

#logger ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def logger
  @logger
end

#non_interactive ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def non_interactive
  @non_interactive
end

#release ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def release
  @release
end

#s3_http_url ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def s3_http_url
  @s3_http_url
end

#s3_region ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def s3_region
  @s3_region
end

#s3_uri ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def s3_uri
  @s3_uri
end

#tile_feature_limit ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def tile_feature_limit
  @tile_feature_limit
end

#timeout ⇒ Object

release: Overture release string (e.g. "2026-06-17.0"). nil means "latest available". cache_dir: where downloaded parquet extracts are stored. s3_http_url/s3_uri/s3_region: data source; point at a mirror (e.g. MinIO) to avoid hitting Overture's bucket from every host. batch_size: default import batch size. timeout: HTTP open/read timeout in seconds. non_interactive: never prompt; pick the best division match and prefer fresh downloads. duckdb_cli_path: explicit path to the duckdb binary (otherwise PATH, then auto-download). logger: receives progress output; defaults to stdout logging from the rake layer. api_auth: callable invoked with the controller before every API request; render/head inside it to reject (nil = open access). api_default_limit / api_max_limit: collection endpoint page sizing. tile_feature_limit: per-tile feature cap for the MVT endpoint.



22
23
24
 
# File 'lib/overture_maps/configuration.rb', line 22

def timeout
  @timeout
end