openapi: 3.0.1 info: title: Elastic Maps File Service description: OpenAPI schema for the Elastic Maps File Service manifest endpoint version: '0.1' contact: name: Presentation Team license: name: Elastic License 2.0 url: https://www.elastic.co/licensing/elastic-license servers: - url: https://vector.maps.elastic.co description: Production - url: https://storage.googleapis.com/elastic-bekitzur-emsfiles-vector-dev description: Staging security: [] tags: - name: ems description: Elastic Maps Service. paths: /latest/manifest: get: operationId: getFileManifest tags: - ems summary: Manifest of the EMS File Service description: Describes the layers available with formats and other metadata parameters: [] responses: '200': description: Manifest is returned content: application/json: example: version: '2023-10-31' layers: - layer_id: world_countries created_at: '2020-10-28T16:16:08.720286' attribution: - label: en: Made with NaturalEarth url: en: http://www.naturalearthdata.com/about/terms-of-use - label: en: OpenStreetMap contributors url: en: https://www.openstreetmap.org/copyright - label: en: Elastic Maps Service url: en: https://www.elastic.co/elastic-maps-service formats: - type: topojson url: /files/world_countries_v7.topo.json legacy_default: true meta: feature_collection_path: data - type: geojson url: /files/world_countries_v7.geo.json legacy_default: false fields: - type: id id: iso2 label: en: ISO 3166-1 alpha-2 code af: landkode (ISO 3166-1 alpha-2) ar: أيزو 3166-1 حرفي-2 regex: ^[A-Z]{2}$ alias: - (geo\.){0,}country_iso_code$ - (country|countries) values: - AD - AE - ZW - type: id id: iso3 label: en: ISO 3166-1 alpha-3 code af: landkode (ISO 3166-1 alpha-3) ar: أيزو 3166-1 حرفي-3 regex: ^[A-Z]{3}$ values: - AND - ARE - ZWE - type: id id: iso_numeric label: en: ISO 3166-1 numeric code af: landkode (ISO 3166-1 numeries) ar: رمز إيزو الرقمي 3166-1 - type: property id: name label: en: name am: ስም alias: - (country|countries) legacy_ids: - World Countries layer_name: en: World Countries zh-tw: 國家 - layer_id: administrative_regions_lvl2 created_at: '2020-07-06T22:19:49.290894' attribution: - label: en: Made with NaturalEarth url: en: http://www.naturalearthdata.com/about/terms-of-use - label: en: OpenStreetMap contributors url: en: https://www.openstreetmap.org/copyright - label: en: Elastic Maps Service url: en: https://www.elastic.co/elastic-maps-service formats: - type: topojson url: /files/admin_regions_lvl2_v2.topo.json legacy_default: true meta: feature_collection_path: data - type: geojson url: /files/admin_regions_lvl2_v2.geo.json legacy_default: false fields: - type: id id: region_iso_code label: en: Region ISO code regex: ^[A-Z]{2}-[A-Z0-9]{1,3}~?$ alias: - (geo\.){0,}region_iso_code values: - AD-02 - AD-03 - AD-04 - type: property id: region_name label: en: Region name - type: property id: country_iso2_code label: en: Country ISO2 code - type: property id: country_iso3_code label: en: Country ISO3 code - type: property id: country_name label: en: Country name legacy_ids: - Administrative regions layer_name: en: Administrative regions zh-sg: 行政领土实体 zh-tw: 行政領土實體 - layer_id: albania_counties created_at: '2019-08-06T22:16:16.377Z' attribution: - label: en: OpenStreetMap contributors url: en: https://www.openstreetmap.org/copyright - label: en: Elastic Maps Service url: en: https://www.elastic.co/elastic-maps-service formats: - type: geojson url: /files/albania_counties_v1.geo.json legacy_default: true fields: - type: id id: iso_3166_2 label: en: ISO 3166-2 code af: ISO 3166-2 ar: أيزو 3166-2 values: - AL-05 - AL-01 - AL-12 - type: property id: label_en label: en: name (en) am: ስም (en) ar: الاسم (en) - type: property id: label_sq label: en: name (sq) am: ስም (sq) ar: الاسم (sq) legacy_ids: - Albania Counties layer_name: en: Albania Counties zh-sg: 阿尔巴尼亚行政区划 zh-tw: 阿爾巴尼亞行政區劃 schema: type: object properties: version: type: string description: Version of the API as a date in YYYY-MM-DD format layers: type: array description: An array of layer descriptions offered by the service minItems: 1 items: type: object required: - layer_id - created_at - attribution - formats - fields - legacy_ids - layer_name properties: layer_id: type: string description: Identifier of the layers created_at: type: string description: Date of the creation of the layer attribution: $ref: '#/components/schemas/attribution' formats: type: array description: The dataset can be offered in one or more different formats minItems: 1 items: type: object required: - type - url properties: type: type: string description: Data layers can be stored in the `topojson` or `geojson` format enum: - topojson - geojson url: type: string description: The relative path to the data legacy_default: type: boolean description: Is this the default format to offer? meta: type: object description: Additional metadata needed to parse the file additionalProperties: true fields: type: array description: Metadata of the fields available on the dataset minItems: 1 items: type: object required: - type - id - label properties: type: type: string description: Fields can be identifiers to join with other datasets or data properties enum: - id - property id: type: string description: A unique identifier for the dataset label: type: object description: A name for the dataset in different languages additionalProperties: true required: - en properties: en: type: string regex: type: string description: A regex that matches the values of the property values: type: array description: The actual values of this property items: type: string alias: type: array description: Alternative names for this property items: type: string legacy_ids: type: array description: Identifier used by older versions of the spec items: type: string layer_name: type: object description: A human-readable descriptor of the dataset in different languages additionalProperties: true required: - en properties: en: type: string '404': description: Manifest not found content: application/xml: example: | NoSuchKeyThe specified key does not exist. schema: type: string components: schemas: attribution: type: array description: The attribution of this data minItems: 1 items: type: object properties: label: type: object properties: en: type: string description: English attribution label url: type: object properties: en: type: string description: Attribution details URL format: URL