您需要让用户搜索附近的内容,在地图上为一个标记显示地址,并提取一个地方的照片和评论——这周内完成。通过本文,您将能够调用Zyla API Hub的Google Maps API上的位置端点,以搜索一个地方,通过纬度/经度解析“这里是什么”,并提取一个地方ID的照片和评论。
此API为您提供的功能
Zyla上的Google Maps API提供:
- 搜索:通过文本查询、坐标、地址、照片和place_id查找地点。
- 这里是什么:反向查找地址和附近的商业上下文,基于纬度/经度。
- 地点照片:使用其地点ID提取一个地方的照片。
- 地点评论:通过地点ID提取用户评论。
这些端点为位置搜索、地图“点击地图”体验和网页及移动应用中的地点详细视图提供支持。
在Zyla API Hub上开始
打开Zyla API Hub上的API页面,点击订阅或在可用时开始7天试用,并获取您的API密钥。Zyla采用订阅和配额模型(不是按调用付费)。对于此API,您可以从7天试用或50个请求开始——请查看API页面以获取当前访问选项和定价。
使用HTTP头进行每个请求的身份验证:
- Authorization: Bearer YOUR_API_KEY
市场聚合了超过10,000个公共API;一个账户和一个API密钥可以跨服务使用,账单一致。创建一个免费账户并直接从API页面获取密钥:在Google Maps API上开始7天试用。
您将使用的端点
1) 搜索
通过文本查找地点。下面的示例在给定的缩放级别下搜索“柏林”。
方法: GET
URL: https://zylalabs.com/api/10107/google-maps-api/19301/search
查询参数(来自示例): query, zoom
curl -s -X GET "https://zylalabs.com/api/10107/google-maps-api/19301/search?query=Berlin&zoom=13" \
-H "Authorization: Bearer YOUR_API_KEY"
示例响应:
{
"status": "ok",
"data": [
{
"business_id": "0x47a84e373f035901:0x42120465b5e3b70",
"phone_number": null,
"name": "Berlin",
"full_address": "德国柏林",
"full_address_array": [
"德国"
],
"latitude": 52.520006599999995,
"longitude": 13.404954,
"review_count": null,
"rating": null,
"timezone": "Europe/Berlin",
"website": null,
"place_id": "ChIJAVkDPzdOqEcRcDteW0YgIQQ",
"place_link": "https://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x47a84e373f035901:0x42120465b5e3b70",
"types": null,
"price_level": null,
"working_hours": [],
"city": "德国柏林",
"is_claimed": false,
"verified": true,
"is_permanently_closed": false,
"is_temporarily_closed": false,
"photos": [
{
"src": "https://lh3.googleusercontent.com/grass-cs/AABkmLffehkFWQeKJcoSb-1YW6L8asBOURQlYg7lDTzlg-TUUjHcP_iZA3YCo6lc1vSKHWpq9OwDIyiwB46OCe5IRwpsCCci5585tr4m6FnBlKPsaS3WVsEA1la8CVcIMhti5jyCmVBW=w203-h126-k-no",
"max_size": [
4963,
3102
],
"min_size": [
203,
100
]
},
{
"src": "https://lh3.googleusercontent.com/grass-cs/AABkmLcK-9P8aapCvGa0e5zeC2wBQm0Y01228VvLazWmPdE7yc_geBaO7DanSWf59BJSHospUgsiE7K6-VjWpB8b3c03ZfvnHzx3LwM50nvfCQ-DCaXA_fqLDhHnTrbcYAfCIzDumboTPQ=w203-h152-k-no",
"max_size": [
12000,
9000
],
"min_size": [
203,
100
]
},
{
"src": "https://lh3.googleusercontent.com/grass-cs/AABkmLfHzbwqyGh-qbjub4sgIBqFw1JqsU9wA-fOOAcEaQi24vqQnx47CebTSe9LxHMr6MfXW2M62qX94rtnpMeS9oFWfll0cW1avvFvgg1PWymyOTAen250DP6tK-Q_cVGIGL003WPOow=w203-h152-k-no",
"max_size": [
4032,
3024
],
"min_size": [
203,
100
]
},…
您实际使用的内容:
- name, full_address, city: 显示结果标题和摘要。
- latitude, longitude: 中心地图或计算接近度。
- place_id, place_link: 深度链接或提取详细信息(例如,照片、评论)。
- timezone: 显示营业时间的当地时间;值遵循IANA(例如,Europe/Berlin)。
- photos[n].src: 显示缩略图;max_size/min_size是像素尺寸。
2) 这里是什么
反向查找坐标的地址和附近的上下文。适用于“在地图上长按”流程或将GPS转换为可读地址。
方法: GET
URL: https://zylalabs.com/api/10107/google-maps-api/19306/what-is-here
所需查询参数:
- lat (string): 例如,48.8719556
- lng (string): 例如,2.3415407
示例请求(参数为清晰起见):
https://zylalabs.com/api/10107/google-maps-api/19306/what-is-here?lat=48.8719556&lng=2.3415407
示例响应(字段缩写):
使用地址和时区进行UI,使用place_id进行下游调用,使用坐标进行地图对齐。值是标准的纬度/经度度数和IANA时区名称。
3) 地点照片
使用其地点ID提取特定地点的照片。非常适合在位置详细信息页面上显示照片库。
方法: GET
URL: https://zylalabs.com/api/10107/google-maps-api/19307/place-photos
请求参数:此处未记录任何其他参数,除了身份验证。使用它提取与一个地方相关的照片。
4) 地点评论
通过地点ID提取用户评论,以丰富详细页面的评分和评论。
方法: GET
URL: https://zylalabs.com/api/10107/google-maps-api/19305/place-reviews
请求参数:此处未记录任何其他参数,除了身份验证。
复制粘贴代码:搜索和解析结果
下面的代码片段调用搜索端点,读取坐标,并提取简单“附近搜索”UI所需的字段。将YOUR_API_KEY替换为您从Zyla获得的密钥。
import requests
API_KEY = "YOUR_API_KEY"
url = "https://zylalabs.com/api/10107/google-maps-api/19301/search"
params = {
"query": "Berlin",
"zoom": "13"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, headers=headers, params=params, timeout=20)
resp.raise_for_status()
payload = resp.json()
if payload.get("status") == "ok":
results = payload.get("data", [])
for item in results:
name = item.get("name")
address = item.get("full_address")
lat = item.get("latitude")
lng = item.get("longitude")
place_id = item.get("place_id")
timezone = item.get("timezone")
photos = item.get("photos", [])
# 打印您UI或日志的紧凑行
print(f"{name} | {address} | {lat},{lng} | place_id={place_id} | tz={timezone}")
# 如果可用,使用第一张照片
if photos:
first_photo_url = photos[0].get("src")
print(f"缩略图: {first_photo_url}")
else:
raise RuntimeError(f"搜索失败: {payload}")
节省时间的设计注意事项
- 时区:API返回IANA名称(例如,Europe/Berlin)。直接与您的时间库一起使用,以本地化营业时间和时间戳。
- 坐标:纬度和经度是十进制度数。对于接近度排序,计算大圆距离或在用户位置周围使用边界框。
- 缩略图:搜索响应已经包含不同大小的照片。将照片URL缓存到您的端,以减少后续加载。
- 地点ID:如果您计划稍后提取照片或评论,请存储来自搜索或这里是什么的place_id。它是链接端点的稳定标识符。
- 配额:Zyla使用订阅+配额,而不是按调用付费。监控您的仪表板中的使用情况。Google Maps API列表提供7天试用或50个请求以开始。
整合在一起:附近搜索流程
一个最小的“附近搜索”流程通常需要三个屏幕:搜索框、地图列表和地点详细信息。以下是如何将每个步骤映射到上述端点。
- 用户输入一个术语:调用搜索,使用查询和缩放获取带有坐标、时区、照片和place_id的候选项。
- 用户点击地图:调用这里是什么,使用纬度/经度显示可读地址,并捕获place_id以获取更深入的详细信息。
- 用户打开一个地方:使用place_id加载地点照片和地点评论,以丰富详细信息页面。
为了提高性能,通过查询+缩放缓存搜索响应,设置短TTL(例如,几分钟)。当用户拖动地图时,仅在中心超出您的阈值时重新查询。
端点参考及示例
搜索
GET https://zylalabs.com/api/10107/google-maps-api/19301/search
示例请求(来自官方示例):
https://zylalabs.com/api/10107/google-maps-api/19301/search?query=Berlin&zoom=13
这里是什么
GET https://zylalabs.com/api/10107/google-maps-api/19306/what-is-here
所需参数:lat, lng
示例请求:
https://zylalabs.com/api/10107/google-maps-api/19306/what-is-here?lat=48.8719556&lng=2.3415407
地点照片
GET https://zylalabs.com/api/10107/google-maps-api/19307/place-photos
此处未记录任何请求参数,除了身份验证。
地点评论
GET https://zylalabs.com/api/10107/google-maps-api/19305/place-reviews
此处未记录任何请求参数,除了身份验证。
通过MCP从AI代理调用API
Zyla上的每个API也可以从兼容MCP的客户端(Claude Code、Cursor、Windsurf等)调用。将您的客户端指向MCP端点并提供您的密钥:
- 端点:https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
从那里,您的代理工具可以调用上述文档中的相同Google Maps API端点。请参阅MCP文档,以在您首选的编辑器或代理运行时中进行设置。
您本周可以发布的实际用例
- 商店定位器:使用搜索查找“米特附近的咖啡”,然后在详细信息页面上显示营业时间和照片,使用地点照片和时区感知标签。
- 地图点击地址:当用户在地图上长按时,调用这里是什么以显示地址卡并启用“保存此位置”。
- 城市指南:预取热门查询的搜索结果;使用place_id为详细信息页面提供地点评论,以便更好地决策。
- 预订或交付半径:按用户位置的距离过滤搜索结果,仅显示在您的服务半径内的项目。
故障排除提示
- 授权失败:确保确切的头格式为Authorization: Bearer YOUR_API_KEY,并且没有额外的空格。
- 稀疏结果:调整您的查询文本(例如,添加城市名称)或更改缩放以扩大/缩小搜索上下文。
- 时间敏感的UI:使用响应中的时区字段来本地化营业时间和用户可见时间。
- 网络可靠性:在瞬态错误上应用短时间限制和基本重试;缓存稳定字段,如place_id和地址。
常见问题解答
我如何进行身份验证?
在每个请求中发送Authorization: Bearer YOUR_API_KEY。
有免费计划吗?
没有。此API采用订阅+配额。请查看API页面以获取当前访问选项;您可以开始7天试用或使用50个请求进行评估。
我如何获取一个地方的照片或评论?
使用来自搜索或这里是什么的place_id,然后分别调用地点照片或地点评论。
纬度/经度的单位是什么?
十进制度数。时区是IANA字符串,例如Europe/Paris。
我可以从AI代理调用这个吗?
可以。在兼容MCP的客户端中使用MCP端点(https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY)并调用相同的端点。
准备好发布您的附近搜索了吗?在Zyla API Hub上创建您的账户,并直接在列表上开始7天试用:在Google Maps API上开始7天试用。