Zh-hant:Overpass API

From OpenStreetMap Wiki
Jump to navigation Jump to search
Overpass API logo.svg
edit
Overpass API · Language reference · Language guide · Technical terms · Areas · Query examples · Advanced examples · Sparse Editing · Permanent ID · FAQ · more (中文(繁體)‎) · Web site
Servers status · Versions · Development · Technical design · Installation · XAPI compatibility layer · Public transport sketch lines · 應用 · Source code and issues
Overpass turbo · Wizard · Overpass turbo shortcuts · MapCSS stylesheets · Export to GeoJSON · more (中文(繁體)‎) · Development · Source code and issues · Web site
Overpass API logo.svg

簡介

Overpass API (先前被稱為OSM Server Side Scripting,或是2011年前被稱為OSM3S),是唯讀,可選擇特定的開放街圖圖資的API。Overpass API扮演網路上的資料庫角色:客戶端送出檢索指令到API這邊,然後得到檢索相關的地圖資料。

Overpass API不像主要的API那樣針對編輯的需求最佳化,而是高度針對資料消費者需求,像是只要稍微看幾個東西,或是用幾分鐘時間下載上億的物件,只要選擇適當的搜尋選項,如:地點、資料類型、標籤內容、周圍,或是上述選項的組合。Overpass API扮演不少服務的後端資料庫。

要得到更詳細資訊,請閱讀完整使用者手冊

Overpass API 比起先前的XAPI為基礎的工具,使用相當強大的檢索語言。要得到更詳細資訊,請見介紹性質的語言指南,或是完整的Overpass檢索語法指南/語法大全。通常我們建議透過interactive 網頁版的前端overpass turbo熟悉Overpass API不同的功能。要為了先前的服務,則有[#XAPI Compatibility Layer|相容性層]]來容許從XAPI順暢的轉換。

公開的Overpass API

要支援小型或是良好擴充的 OSM 主要服務,Overpass API 以第三方服務的方式提供服務。你可以用公開服務的站台:

名稱 資料覆蓋範圍 端點 版本 最新資料 硬體 Munin 使用政策
Main Overpass API instance Global https://lz4.overpass-api.de/api/interpreter 0.7.56.7 b85c4387 是 4 實體核心, 64 GB RAM, SSD Link 三個伺服器任何一個都能每天接受1,000,000的連線請求,你只要每天連線沒有超過10,000檢索,或每天下載量少於5GB資料的話,肯定不會防礙其他使用者。網址overpass-api.de與端點https://overpass-api.de/api/interpreter https://overpass-api.de/api/interpreter]會持續運作,並且每次輪流導向zlz4
主要Overpass API站臺 Global https://z.overpass-api.de/api/interpreter 0.7.56.8 7d656e78 是 4 實體核心, 64 GB RAM, SSD Link
俄羅斯Overpass API站臺 全球 http://overpass.osm.rambler.ru/cgi/interpreter 0.7.55.7 8b86ff77 没有 8 核心, 64 GB RAM, 硬碟 ?
法國Overpass API站臺 全球 http://api.openstreetmap.fr/oapi/interpreter 0.7.54.10 2e325488 没有 8 核心, 16 GB RAM, SSD [1] 歡迎任何目的用API,只要每天每個"專案"連線沒有超過1,000次檢索的話。(用"專案"計算表示用API在你的智慧型手機App,每天客戶有10,000次檢索,你應該就超過數目了)
瑞士Overpass API站臺 只有瑞士 http://overpass.osm.ch/api/interpreter 0.7.55.7 8b86ff77 没有 12 核心, 64 GB RAM, 硬碟 ? 詢問User:Datendelphin
kumi.systems Overpass API 全球 https://overpass.kumi.systems/api/interpreter 0.7.56.3 eb200aeb 是 20 核心 3 臺伺服器, 256GB RAM, 每個 SSD - 儘管為任何專案使用這臺伺服器,每一臺伺服器都能個別透過 1.overpass.kumi.systems, 2.overpass.kumi.systems 和 3.overpass.kumi.systems 找到。到主要的網址都能平均分配到每一臺,並且儘可能使用。操作上的疑問/問題嗎?請到張貼支援票
台灣 Overpass API 全球 https://overpass.nchc.org.tw 0.7.56.3 eb200aeb 是 ? ? 如果你有任何問題或回饋意見,請聯繫 OSM.tw 或是 聯繫國網中心自由軟體實驗室

開放歷史地圖也有Overpass API端點。

Overpass API的檢索型式有XML或是Overpass QL,請在下面的章節觀看系統性的解釋。你可以使用Overpass turbo前端來創造或顯示前面提到的Overpass API站臺。

Overpass API也提供永久連結

社群:我能幫上什麼?

當然:請先詳讀說明文件

已經有許多針對Overpass API和Overpass Turbo相關問題提供協助的社群網站,如果你的問題其他也有興趣,一般建議可以在上面詢問入門到專家等級的問題。

請注意這些網站上面的老問題與解答常常已經過時了。還沒有的功能已經實作了,而繞道的方式已經主流了,我預測大概兩年後就失效了。

此外,只有OSM Help是由OSM社群經營的園地,其他網站由第三方維運。

網站 語言 常見問題最常用的'標籤'
OSM Help 英語 overpass, overpass-turbo
GIS StackExchange 英語 overpass-api
Stack Overflow English overpass-api
OSM US Slack (channel #overpass) 英語
OSM Dev Telegram group 英語
OSM World Discord (channel #developer) 英語

開發者 / 系統管理員

你可以從最新穩定版,或者從git原始碼倉櫥(最新版本)安裝你自己的站臺。相關程式碼授權為Affero GPL v3.

這項專案由Roland Olbricht (mail: roland.olbricht@gmx.de)維護。而像是回報臭多或是pull requests 到原始碼則相當歡迎。

另外也有開發者郵件論壇

書籍

Olbricht, Roland (2015). “OpenStreetMap in GIScience”. in Jokar Arsanjani, J.; Zipf, A.; Mooney, P. et al.. Springer International Publishing Switzerland. pp. 101-122.