什么是 positionstack，是什么讓它強大？

positionstack 是一種 API 服務，它提供了簡單可靠的正向和反向地理編碼解決方案。該服務覆蓋全球超過 20 億個地點和地址。

Positionstack API 的功能包括批量地理編碼、多語言支持以及可嵌入地圖 URL 等。您可以選擇 JSON、XML 或特定于地理編碼的 GeoJSON 格式來獲取地理位置 API 的結果。API 的平均響應時間在 10 毫秒到 100 毫秒之間，具體取決于您的請求大小。

• 正向地理編碼
• 反向地理編碼
• 批量請求
• 可嵌入地圖
• JSON，XML 和 GeoJSON
• 多種語言

positionstack 已成為許多企業的 Go to Geolocation API。以下是 Positionstack 用戶每天請求 1+ 億次地理編碼 API 查找的原因：

• 覆蓋全球超過20億個地址！
• 實時地理編碼：對任何全球地址或坐標集進行實時地理編碼，并查找位置組件、國家/地區和時區數據等等。
• 可擴展的基礎設施：apilayer 云基礎設施支持 Positionstack，使其能夠處理數十億個地理編碼請求，響應時間在 10 到 100 毫秒之間。
• 全球覆蓋范圍：充分利用來自高質量數據供應商的大量全球地理編碼數據，每天多次更新。
• 公平定價：您每月免費獲得10，000個地理編碼請求。如果您需要更多，高級地理編碼訂閱每月僅需9.99美元。

apilayer是一家奧地利技術公司，構建了各種可靠的編程接口（API），它構建并維護了positionstack API。apilayer為開發人員和初創公司提供價格合理的尖端API。

簡而言之，positionstack是市場上最先進、最輕量級、最經濟實惠、最易于使用的地理編碼解決方案。本文詳細介紹了它的各種API端點、可用選項以及Node.js和其他平臺（Postman和RAD Studio REST插件）的教程。

如何訪問positionstack API？

首先獲取您的API憑據，并設置您的訂閱計劃：

您可以通過此儀表板監控您的使用情況。

API訪問密鑰和身份驗證

接下來，要檢查是否一切正常，只需在您最喜歡的Web瀏覽器中運行此URL：

http://api.positionstack.com/v1/forward?access_key=YOUR_ACCESS_KEY&query=1600%20Pennsylvania%20Ave%20NW,%20Washington%20DC

您應該在瀏覽器中看到此API響應：

API錯誤

如果您的API請求失敗，API將返回一個錯誤對象。它包含子對象代碼和指示所發生錯誤類型的消息。

以下是最常見的API錯誤：

哪些正向地理編碼端點可通過 API 獲得？

正向地理編碼是將自由文本地址或地點轉換為位置數據的過程。要發出正向地理編碼請求，請使用API的正向端點并使用查詢參數指定查詢。

以下是HTTP GET請求參數：

每個API響應由18個不同的響應對象組成：

通過API可以使用哪些反向地理編碼端點？

反向地理編碼是將坐標（緯度/經度）或IP地址轉換為位置數據的過程。要發出反向地理編碼請求，請使用API的反向端點，并使用查詢參數指定查詢。

HTTP GET請求參數

以下是HTTP GET請求參數：

響應對象

每個API響應由20個不同的響應對象組成：

如何使用 Node.js 執行正向地理編碼？

positionstack API與所有主流編程語言兼容。

使用以下代碼通過Node.js發出正向地理編碼API請求：

const axios = require('axios');

const params = {

  access_key: 'YOUR_ACCESS_KEY',

  query: '1600 Pennsylvania Ave NW, Washington DC'

}



axios.get('http://api.positionstack.com/v1/forward', {params})

  .then(response => {

    console.log(response.data);

  }).catch(error => {

    console.log(error);

  });

以下是Node.js IDE內的API響應（在此示例中使用Atom）：

如何使用 Node.js 執行反向地理編碼？

使用以下代碼通過Node.js發出反向地理編碼API請求，請記住，您需要輸入緯度和經度來進行查詢搜索：

const axios = require('axios');

const params = {

  access_key: 'YOUR_ACCESS_KEY',

  query: '38.897675, -77.036547'

}



axios.get('http://api.positionstack.com/v1/reverse', {params})

  .then(response => {

    console.log(response.data);

  }).catch(error => {

    console.log(error);

  });

以下是Node.js IDE內的API響應（在此，我在此示例中使用Atom）：

額外獎勵：使用其他平臺的 API 請求

如何使用 RAD Studio REST Debugger 發出 API 請求？

首先，下載 Delphi REST Debugger。

選擇GET方法，并將請求發送到以下URL（反向地理編碼的示例）：

http://api.positionstack.com/v1/reverse?access_key=YOUR_ACCESS_KEY&query=40.7638435,-73.9729691

在獲得所需的API響應后，如果您想用Delphi來創建一個基于它的桌面應用程序，請參考本文：https://blogs.embarcadero.com/using-apilayer-rest-apis-from-delphi/

如何使用 Postman 發出 API 請求？

如果這是您第一次使用Postman，您可以在我們的博客文章中閱讀有關安裝指南：https://blog.apilayer.com/easily-spider-websites-using-node-js-and-powerful-rest-apis/

選擇GET方法，并將請求發送到以下URL：

http://api.positionstack.com/v1/reverse?access_key=YOUR_ACCESS_KEY&query=40.7638435,-73.9729691

您準備好將強大的地理編碼功能集成到您的應用程序中了嗎？

如您所見，PositionStack REST API 提供了一系列精確的地理編碼服務。無論是正向還是反向批量地理編碼，都可以將這些API端點連接到您使用的任何平臺和編程語言中。

在本文中，我們將向您展示如何使用 PositionStack REST API 進行基本的正向和反向地理編碼操作。

利用 PositionStack 的免費層吧！如果您需要更強大的功能（例如 HTTPS 加密、擴展速率限制、JSON、XML、GeoJSON、嵌入式地圖等），我們強烈建議您升級訂閱計劃。如果這還不夠，請聯系我們以獲得定制解決方案。我們迫不及待地想看看您使用我們的REST API構建的內容！

常見問題

什么是地理編碼？

地理編碼是將地址轉換為地圖點。例如，它將“1600 Amphitheatre百老匯，山景，CA”更改為顯示其在地圖上位置的坐標（如緯度37.423021和經度-122.083739）。

地理編碼的工作原理是什么？

地理編碼是一種利用特殊服務（例如谷歌地圖）在地圖上精確定位一個地址的技術。它通過查詢數據庫、運用算法和分析地圖數據來實現這一過程。

什么是反向地理編碼？

反向地理編碼則相反。它將坐標轉換成人們可以理解的地址。例如，它會將緯度和經度更改為“1600 Amphitheatre百老匯，山景，CA”。

人們使用地理編碼做什么？

地理編碼有助于地圖應用程序（如谷歌地圖），查找附近的地方（如餐館），以及使用地圖分析和顯示信息的系統。

地理編碼有什么問題嗎？

有時地理編碼可能會出現錯誤，特別是在那些人口稀少的地區。此外，如果地址信息過時或者有誤也可能會引發其它問題。由于地理編碼常常需要共享位置數據，所以還涉及到隱私方面的考量。

如何找到更多同類API？

冪簡集成是國內領先的API集成管理平臺，專注于為開發者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API：通過關鍵詞搜索API、或者從API Hub分類頁進入尋找。

立即免費注冊，開始將精確且豐富的正向和反向地理定位數據集成到您的應用程序中！

原文鏈接：https://blog.apilayer.com/how-to-get-started-with-powerful-a-geo-api-service-using-nodejs/

#你可能也喜歡這些API文章!

常用文檔轉換API匯總

2024年國內熱門天氣環境API

使用第三方API擴展低代碼/無代碼平臺的功能

AI 驅動的 API 如何改變招聘：2024 年國內外頂級招聘相關API

Ipstack 案例研究：Airbnb 如何使用地理位置 IP 地址來展示房源

網易企業郵箱API 終極指南：功能、定價和實施

OpenAI API定價及成本計算

面向開發人員的 10 個最佳股票 API

釋放創意潛能：AI3D模型生成服務EasyPeasy的集成指南