地点查询服务-Geoapify

Geoapify Places API 是一项服务，它使开发人员能够以编程方式搜索和检索有关地点和兴趣点的信息。它提供对庞大位置数据库的访问，使您可以将地点搜索功能整合到您的应用程序和网站中。

1.支持的类别

我们广泛的地点类别列表不断增加，目前已支持 500 多个类别，并且还在不断扩展。此外，我们的类别是分层的，可让您在顶级搜索或更具体的搜索之间进行选择。

探索此处提供的完整类别列表，开启定制和精确地点搜索的无限可能。

2.寻找合适地点的条件

除了广泛的类别选项外，API 还允许您指定地点应遵守的条件。以下是在 Places API 查询中组合类别和条件的几个示例：

• 查找免费停车位：将类别“停车”与条件“免费”相结合，即可搜索提供免费停车的地点。轻松找到方便且经济实惠的停车选择。
• 素食者友好型互联网接入：使用类别“catering.restaurant”以及条件（如“internet_access”和“vegan.only”）来查找提供互联网接入并专门供应素食的餐厅。享受满足您特定偏好的用餐体验。
• 适合狗狗的旅游景点：将类别“tourism.sights”与条件“dogs”相结合，即可找到适合狗狗的旅游景点。探索新目的地，同时确保您的宠物受到欢迎。

通过访问此处的列表来了解所支持的全部条件，并解锁定制和个性化地点搜索的无限可能性。

3.位置过滤器和偏向

Places API 提供了强大的位置过滤器和偏差选项来微调您的位置查询 - 搜索边界框或半径内的地点，发现可达区域，并根据接近度精确定位位置。

4.获取地点详细信息

要获取每个地点的全面信息，您可以使用地点详情 API，该 API 允许您请求地点 API 返回的有关特定地点的详细数据。

地点详情 API 为您提供地点的几何形状，其中包含丰富的结构化数据，可提供有关该地点各个方面的宝贵见解，例如其地址、联系信息、营业时间等。通过利用地点详情 API，您可以访问深入的结构化信息，以增强应用的功能，并在用户探索和与地点互动时为他们提供更丰富的体验。

1.全面的数据覆盖：

Geoapify提供全球范围内的地理数据，确保用户能够在任何地方获得准确和详细的地点信息。

2.高精度和高性能：

提供高精度的地理位置和路线规划，确保数据的准确性和实时性，同时通过优化的查询算法提升响应速度。

3.丰富的POI数据：

提供详细的兴趣点（Points of Interest, POI）数据，包括餐馆、酒店、加油站、银行等多个类别，支持多维度的地点搜索。

4.自定义和灵活性：

支持自定义查询参数，如语言、结果数量、偏好设置等，满足特定应用的需求。

5.易于集成：

提供简单易用的API接口和详细的文档，方便开发者快速集成到自己的应用或服务中。

6.强大的数据更新机制：

定期更新地理和POI数据，确保用户获得最新的信息。

7.数据隐私和安全：

重视用户数据隐私，采用安全的数据传输和存储机制，保障用户数据安全。

1.基于位置的推荐：通过为用户当前位置附近的餐厅、景点和住宿提供个性化推荐，增强您的旅行应用。例如，“根据您当前的位置发现附近的高评分餐厅和热门景点。”

2.旅行规划：通过集成 Places API 为用户提供目的地景点、餐厅和住宿的详细信息，从而促进旅行规划。例如，“通过探索您理想旅行目的地的热门景点、顶级餐厅和推荐酒店来规划您的梦想假期。”

3.企业查找器：创建本地企业目录，允许用户搜索特定类型的企业，例如“查找您所在地区最近的宠物美容服务”。

4.路线规划：通过集成 Places API 来识别沿途的加油站、休息站和餐饮选择，从而优化路线规划。例如，“使用详细的路线建议规划您的公路旅行，包括附近的加油站和餐馆。”

5.房地产搜索：整合 Places API，帮助用户查找特定位置附近且配备所需设施的房产。例如，“探索您喜欢的社区内学校、公园和购物中心附近的待售房屋。”

6.基于地理位置的营销：根据用户与特定地点的距离，向用户提供优惠和促销活动，从而开展基于位置的营销活动。例如，“使用我们基于位置的优惠，解锁附近咖啡店的专属折扣。”

7.紧急服务定位器：集成 Places API，在紧急情况下快速定位附近的医院、警察局和紧急服务。例如，“在紧急情况下查找最近的医院和医疗机构。”

8.城市指南：制作全面的城市指南，提供有关景点、历史地标、交通选择等的信息。例如，“浏览我们的城市指南，了解必游地标、隐藏的瑰宝和当地交通提示。”

9.宠物友好地点：创建一款应用，帮助宠物主人在与宠物一起旅行时找到宠物友好公园、咖啡馆和酒店。例如，“发现您附近适合宠物的公园，与您的四条腿朋友一起享受有趣的郊游。”

10.户外活动：帮助户外运动爱好者找到附近的徒步小径、公园、露营地和其他户外休闲活动。例如，“发现附近的徒步小径、公园和露营地，为您的下一次户外探险做好准备。”

要开始在您的应用程序中使用 Geoapify Places API，请按照以下步骤操作：

1. 注册并获取 API 凭证

在 Geoapify 网站上注册一个帐户以接收您的 API 凭证，包括 API 密钥。此密钥将用于验证您对 Places API 的请求。

访问我们的地图 API 入门页面，了解有关 Geoapify 帐户和 API 密钥的更多信息。

2. 构造 API 请求

深入了解Places API 文档，其中提供了有关 API 参数的全面信息，或者使用API Playground生成请求 URL。

以下是查询美国华盛顿特区医疗保健场所视图框的 API URL 示例：

https://api.geoapify.com/v2/places?categories=healthcare&filter=rect:-77.03921757581298,38.90660286449031,-77.01762874146101,38.88987145915573&limit=100&apiKey=YOUR_API_KEY

3. 发送 API 请求

Places API 通过 HTTP Get 请求工作。使用编程语言的相应 HTTP 客户端库将 API 请求发送到指定端点。在每个请求中包含您的 API 密钥作为身份验证标头或查询参数。

以下是发送 API 请求的代码示例：

fetch('https://api.geoapify.com/v2/places?categories=commercial&filter=rect:7.735282,48.586797,7.756289,48.574457&limit=200&apiKey=YOUR_API_KEY')
.then(resp => resp.json())
.then((places) => {
	console.log(places);
});

4.处理 API 响应

在您的应用程序中捕获 API 响应并进行相应处理。响应将包含GeoJSON格式的请求地点数据，让您能够提取相关信息，例如地名、地址、坐标和所有相关地点类别。

以下是一些解决特定业务问题的 API URL 示例：

搜索慕尼黑市中心可见区域内的餐厅

让我们搜索慕尼黑市中心的 100 家餐厅。我们将查询“catering.restaurant”类别。以下是可以完成此工作的 URL：

https://api.geoapify.com/v2/places?categories=catering.restaurant&filter=rect:11.549881365729718,48.15114774722076,11.58831616443861,48.12837326392079&limit=100&apiKey=YOUR_API_KEY

搜索柏林亚历山大广场步行 10 分钟内的厕所

您可以通过两个步骤找到 10 分钟内可到达的 WC 列表：

https://api.geoapify.com/v1/isoline?lat=52.521670650000004&lon=13.413278026558228&type=time&mode=walk&range=600&apiKey=YOUR_API_KEY

https://api.geoapify.com/v2/places?categories=amenity.toilet&filter=geometry:GEOMETRY_ID&bias=proximity:13.413637435864272,52.52197645&limit=100&apiKey=YOUR_API_KEY

我们还添加与原始位置相对应的偏差，以便按接近度对结果进行排序。

查询无障碍地点最近的50个旅游景点

我们将结合使用“tourism.sights”类别和“轮椅”条件进行查询：

https://api.geoapify.com/v2/places?categories=tourism.sights&conditions=wheelchair&bias=proximity:7.744380838810624,48.5873243&limit=200&apiKey=YOUR_API_KEY

这些 API URL 演示了如何利用 Geoapify Places API 解决各种业务问题。将 URL 中的“YOUR_API_KEY”替换为您的实际 API 密钥，以发出有效请求并接收所需的地点数据。