使用 Positionstack API 免費獲得企業級地理編碼（審查）

您不必成為 Google 地圖即可從地理編碼中獲得價值。而且，多虧了 Positionstack，您也不需要 Big G 的技術預算來這樣做。今天，我們回顧了 Positionstack 強大的 API，它旨在使企業級正向和反向地理編碼既經濟又實用。

位置堆棧 101

那麼，您為什麼要費心閱讀Positionstack上的 2,000 多個字的評論，您將獲得什麼？答案聽起來很可愛，但它是正確的：在整個世界。

考慮一下世界地圖上有多少個地方。現在，將您的企業需要了解的有關這些地方的每一條元數據乘以您頭腦中的那個數字。這就是 Positionstack 提供的，然後是一些。

讓我們看一下有關 Positionstack 的一些快速統計數據：

• 每天每小時處理數十億個地理編碼查找請求；具有 100% 的正常運行時間和 < 100ms="" response="">
• 基於雲的、高度可擴展的基礎架構
• 世界上每個國家的實時數據，編譯成一個每隔幾個小時更新一次的海綿狀數據集
• 慷慨分配，價格具有競爭力的訂閱計劃；加上無與倫比的免費用戶每月 10,000 次請求的配額
• 對所有主要編程語言的集成支持
• 包含代碼片段的全面、易於閱讀的文檔
• 世界一流的客戶滿意度團隊，擁有為 Zendesk、Slack、LinkedIn、Lyft、Apple 和 Amazon 等客戶提供服務的經驗

Positionstack 肯定有它的血統，但如果您不相信一些要點，讓我們深入了解實際使用 API 的感覺。

Positionstack 的三步快速入門指南

如果您在他們的網站上花一些時間，您會發現 Positionstack 確實強調易用性，這是他們 API 的主要賣點。在註冊過程中，您會立即發現這是真的。事實上，在輸入您的帳戶憑據後，您首先看到的是一個快速路線圖，其中包含通過三個簡單步驟啟動和運行 Positionstack 所需的內容。讓我們來看看：

1. 設置您的 API 訪問密鑰– 默認情況下，您會收到一個開箱即用的訪問密鑰。但是，您可以根據需要輕鬆地將其重置。
2. 選擇 API 端點——我們在下一節更深入地介紹 API 端點，但現在只了解這一步是指配置當您的應用程序向 Positionstack 發出請求時返回的數據類型。在這裡，您首先會看到基本 URL，這是您定位請求的位置，但它也出現在文檔中。最後，我們看到了一個示例 API 請求，它只包含幾行簡單的代碼。
3. 應用程序集成——最後一步是指將 Positionstack 的 API 最終集成到您的應用程序中。關於這個過程有很多需要了解的，其中大部分都包含在文檔中。這裡重要的是：Positionstack 的支持團隊支持您，並會提供盡可能多或盡可能少的幫助，幫助您配置 API 並將其集成到您的應用程序中。

很容易吧？對於一開始沒有廣泛 IT 知識的人來說，API 似乎令人生畏。但是馬上，Positionstack 會讓您感到安慰，因為它不僅很容易，而且還會通過有關其智能設計的令人難以置信的文檔一路幫助您。這有助於他們擁有一支充滿激情的專家團隊，隨時準備為您提供幫助。

您的位置堆棧儀表板

Positionstack 將其用戶友好性的核心價值加倍，提供了一個精簡、整潔的儀表板，您可以從中訪問您需要了解的有關 API 的所有信息。讓我們來看看側邊欄選項：

• 儀表板– 您會在此處找到通知（通常在您超過特定使用閾值時提醒您），然後鏈接到三步快速入門指南及其文檔頁面。還有您的 API 密鑰、您當前的訂閱、帳戶詳細信息和付款方式的概述。
• 升級/訂閱– 您可以通過這兩個選項之一更改訂閱。隨時升級，但如果您想在任一方向的月度或年度計劃之間切換，您需要先降級到免費帳戶，然後選擇所需的選項。如果您需要幫助，Positionstack 支持人員願意為您提供幫助。
• 賬戶/付款——這些都是不言自明的；任一選項卡都允許您隨時更新您的憑據。必須說，我們很欣賞他們沒有將這些基本控件隱藏在過度設計、華麗的界面中。所見即所得。
• API 使用- 可能是您最常訪問的選項卡，在這裡您可以找到到目前為止您已經消耗了多少每月請求配額。還有一個方便的部分顯示您隨時間推移的使用統計數據，因此您可以相應地調整您的策略。

API 文檔

現在我們進入 Positionstack 產品的核心和靈魂：API 文檔。將此頁面視為您的首選用戶手冊，其中詳細介紹了每個 API 端點、它們的參數以及它們將返回的信息類型。

此頁面分為五個不同的部分。我們將逐一介紹，花一些時間和措辭為您提供一些背景信息，以便您更好地了解您會發現什麼。

入門

在這裡，您將找到適用於您使用 Positionstack 發出的每個請求的基本函數。這些是：

• API 密鑰– 您的 API 密鑰就像您用來訪問 Positionstack 數據集的數字護照。沒有它，API 對您毫無用處。如果您認為它已被洩露，您可以輕鬆地將舊密鑰輪換為新密鑰。
• 加密– 256 位 SSL 加密在整個 Internet 中使用，這是有充分理由的安全行業標準。雖然您需要一個基本計劃或更好的計劃來加密您的應用程序與 Positionstack 的服務器的通信，但投資本身是非常值得的。為了喚起加密，只需在 API 基本 URL 中將 HTTP 更改為 HTTPS。簡單的！
• JSON 回調——我們不會涉及太多有關其工作原理的技術細節，但如果您的 API 請求受到同源策略的阻礙，您可以使用 JSON 回調來影響解決方法。從本質上講，您從外部腳本請求數據，該腳本不會因跨域問題而陷入困境。
• API 錯誤– 與任何事情一樣，有時您的 API 請求會遇到錯誤。Positionstack 了解這一點，並在他們的應用程序中內置了錯誤報告功能，以幫助您識別出了什麼問題。API 請求失敗會自動返回一個 JSON 格式的錯誤對象，加上代碼、消息和上下文子對象，為錯誤提供上下文。

API 端點

本節記錄了 Positionstack 的肉和土豆功能，即正向和反向地理編碼。如果您不能 100% 確定區別是什麼，請將地理編碼視為一種雙向街道，您可以將用簡單英語書寫的地點和地址轉換為坐標和 IP 地址等位置數據，反之亦然。

因此，您將使用前向地理編碼將埃菲爾鐵塔的位置轉換為坐標。同樣，您可以使用反向地理編碼找出與 IP 地址關聯的街道地址。畢竟很簡單！

正向/反向地理編碼請求

為了對任一類型的地理編碼發出基本請求，您需要將適當的端點（/forward 或/reverse）附加到 API 的基本 URL。接下來，你會提供您的訪問密鑰，然後做一個查詢使用一個純英語位置的地址或其對應的位置數據和，瞧！它看起來像這樣：

https://api.positionstack.com/v1/forward
    ? access_key = YOUR_ACCESS_KEY
    & 查詢 = 1600 Pennsylvania Ave NW, Washington DC

或者

https://api.positionstack.com/v1/reverse
    ? access_key = YOUR_ACCESS_KEY
    & 查詢 = 40.7638435,-73.9729691

當然，Positionstack 的數據集包含的不僅僅是地址和坐標。您可以通過使用各種參數來解析這些其他分類。這是查詢白宮的正向地理編碼請求的示例：

{
   “數據”： {
      “結果”： [
         {
            “緯度”：38.897675，
            “經度”：-77.036547，
            "label": "1600 Pennsylvania Avenue NW, Washington, DC, USA",
            "name": "1600 賓夕法尼亞大道 NW",
            “類型”：“地址”，
            "number": "1600",
            "street": "賓夕法尼亞大道西北",
            "postal_code": "20500",
            “信心”：1，
            "region": "哥倫比亞特區",
            "region_code": "DC",
            “administrative_area”：空，
            "neighborhood": "White House Grounds",
            "國家": "美國",
            "country_code": "美國",
            "map_url": "https://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

有趣的是，如果您使用白宮的近似坐標執行反向地理編碼請求，返回的結果看起來幾乎相同，除了您還會看到您的坐標與白宮官方坐標之間的距離差異，因為它們出現在 Positionstack 的數據集。

這種相似性的原因是兩個端點都使用相同的 GET 參數數組，因此能夠返回（幾乎）相同的響應對象。這意味著無論您必須通過什麼起始數據，您都可以獲得完整的位置數據作為回報。（可以使用 API 的fields 參數縮小這些結果的範圍，但我們稍後會詳細介紹。）

注意：Positionstack 的文檔頁面詳細介紹了每個參數和響應對象，因此請務必查看！

批量請求

此文檔設置中的最後一個主要標題處理批處理請求。您所要做的就是調用批處理 參數，然後在單個請求中嵌套多個查詢實例（以及您想要的參數），而 Positionstack 的 API 負責其餘的工作。它非常簡單，看起來像這樣：

{
   “批”：[
      {
         "query": "大街",
         "國家": "美國",
         “地區”：“明尼蘇達”
      },
      {
         "query": "大街",
         "國家": "美國",
         “地區”：“伊利諾伊州”
      },
      {
         "query": "大街",
         "國家": "美國",
         “地區”：“密蘇里州”
      }
   ]
}

高級數據

除了基本的位置參數，您還可以進一步定制您的 API 請求以返回更高級的數據。這些包括：

• 可嵌入地圖– 返回鏈接到您的地理編碼結果的 map_url 對象，您可以使用它在您的網站或應用程序上創建有吸引力的視覺地圖表示。
• 國家模塊- 與返回幾個響應對象的其他參數不同，country_module返回有關您查詢的國家的令人難以置信的數據數組。這也不僅僅是坐標和地址；它是首都、國旗、官方名稱、內陸（或非內陸）國家的地位、使用的貨幣、使用的語言、呼叫代碼等等。
• 太陽模塊——幽默地，Positionstack 的文檔將其描述為“占星術”數據。您不會使用此參數獲得星座運勢，但您會根據天文、民用和航海年表查看有關太陽升起和落下時間的數據。
• 時區模塊- 附加timezone_module以秒或作為自然語言字符串返回位置的 GMT 偏移量。
• 邊界框模塊- 如果單個 x/y 坐標對不適合您的任務，請嘗試使用邊界框，它包含經度和緯度的最小值和最大值的區域。

其他選項

Positionstack API 有大量數據可供您使用，但幸運的是，它為您提供了額外的工具來管理這些信息。

• 指定響應字段——我們已經深入介紹了 Positionstack 可以返回多少數據，但請記住，所有這些數據都是有代價的。如果您想限制每月的請求，您可以使用字段Appending fields = results.flag來做到這一點，例如，這將導致 API 僅輸出您查詢的國家/地區的國旗。您可以根據需要多次調用字段以獲取所需的特定數據集。
• 指定輸出格式- 免費訂閱者的返回地理編碼結果僅限於 JSON 格式。但是，付費客戶可以在他們的請求中附加輸出，以根據需要指定 JSON、XML 或 GeoJSON。 

代碼示例 

當 Positionstack 說他們是來幫助你時，他們是認真的。我們已經看到了他們的文檔是多麼詳盡，但是他們在其 API 支持的所有語言中都提供了方便的代碼示例。我們不會在這裡複製/粘貼該代碼，但為了快速參考，這些語言是：

• Python
• 節點
• jQuery
• 去
• 紅寶石

證明和表現

在這一點上，應該很清楚 Positionstack 能夠做很多事情。但是，它在這些方面做得如何？

首先，讓我們考慮一些背景。Positionstack 是 Apilayer 基於雲的生態系統中 20 多個 API 微服務之一。這些 API 一起為超過一百萬的 B2B 客戶提供服務，從初創公司一直到企業。他們最著名的一些客戶包括亞馬遜、蘋果、Slack、LinkedIn 以及更多家喻戶曉的名字。顯然，他們擁有一些強大的基礎設施來處理這種規模的需求。

就其自身的優點而言，Positionstack 不負眾望，在撰寫本文時，它在整個 2020 年實現了令人難以置信的 100% 正常運行時間。當您考慮到 API每天為每個鯨魚客戶端例行處理超過 10 億次地理編碼查找時，這更令人印象深刻，更不用說來自其穩定的 SMB 客戶的令人眼花繚亂的同時請求陣列。更重要的是，這些請求通常會在 10 到 100 毫秒之間獲得響應。

在我們的書中，這是一個技術奇蹟，尤其是考慮到這種 SaaS 產品的定價如此激進。

使 Positionstack 如此吸引人的不僅僅是原始力量。他們的數據集非常複雜，來自可靠的名稱，如 Nominatim、GeoNames、Pelias 和 OpenStreetMap。Positionstack 每天多次交叉檢查、過濾和重新組合這些豐富的數據，通過智能算法推送定期更新，確保您在世界任何地方始終擁有高度準確的位置數據，並且是實時的。

我們不想破壞我們的最終裁決，但如果您正在尋找一個強大的、可擴展的地理編碼解決方案，Positionstack 的簡歷需要仔細看看。

價錢 

Apilayer 著手為昂貴的企業級地理編碼軟件提供一種經濟實惠的替代方案，並為此取得了成功。

Positionstack 有五個定價層，並支持按月計費或按 20% 的折扣按年訂閱。這些層是：

• 免費– 額定供個人使用，您仍然可以通過每月 25,000 次正向和反向地理編碼請求（以 JSON 格式輸出）獲得不錯的收益。您沒有獲得很多高級功能或客戶支持，但我們已經向您展示了他們的文檔頁面是多麼寶貴的資源。這一層是免費的，沒有義務——您甚至不必提供信用卡詳細信息即可開始使用。
• Basic – 入門級商業包。基本訂閱者的每月配額增加了四倍，達到 100,000 個地理編碼請求，此外還可以訪問高級功能，例如 HTTPS 加密、多種輸出選項（JSON、XML、GeoJSON）、可嵌入地圖、多種語言等。每月只需​​ 9.99 美元即可獲得商業 Positionstack 許可證。
• Professional – Positionstack 最受歡迎的產品，Professional 層提供了十倍的地理編碼請求——每月高達 1,000,000。基本層的所有優點都存在，然後是一些，特別是包括重型應用程序的批處理請求。這一層的價格為每月 49.99 美元。
• 業務– 進入企業級性能，業務層將每月配額膨脹到高達 3,000,000 個請求。再一次，每項高級功能都完全可用，由 Positionstack 熱情的客戶支持團隊提供支持，可幫助您充分利用它們。每月 99.99 美元。
• 企業– 這是標準優惠退出的層級，客戶為王。您有需要定制解決方案的精確需求，Positionstack 隨時準備實現您的目標。你決定你每月的數量要求，即使（特別是）如果它們是可變的。需要來自 API 的更多功能？聯繫支持定制解決方案。聯繫 Positionstack 獲取報價。

判決書

Positionstack 完全按照它的計劃去做：在不犧牲性能的情況下，將企業級地理編碼從價格點降低到大多數 SMB 的預算之外。他們的 API 文檔齊全且易於使用，但具有跨所有主要編程語言的強大集成功能，可實現最大效用。Positionstack 常規處理的請求數量驚人，而他們的數據集經過巧妙維護，以實現真正的全球實時地理編碼。如果您在市場上購買此類產品，請不要依賴 Positionstack。

您計劃進行什麼樣的整合？您將如何在您的業務中使用地理編碼？您對 Positionstack 有任何問題或意見嗎？在下面的評論中給我們留言。