19、地图服务设计：从只读到读写资源的转变

地图服务设计：从只读到读写资源的转变

一、只读地图服务的响应处理

在只读地图服务中，会遇到各种不同的请求情况，针对这些情况需要给出合适的响应代码。以下是常见情况及对应的响应处理：
| 请求情况 | 响应代码 | 说明 |
| — | — | — |
| 搜索未知地点 | 404（Not Found） | 当尝试搜索但不知道客户端所说的地点时，返回此代码。例如搜索不存在的地名“Tanhoidfog”，目前它不存在，但未来可能会有。 |
| 请求逻辑上不可能的经纬度 | 400（Bad Request） | 像请求经纬度为 500,-181（北纬 500 度，西经 181 度），由于几何定律，这样的地点不可能存在，客户端在请求前应能判断，所以返回此代码更精确。 |
| 地图搜索无结果 | 200（OK） | 例如在加利福尼亚州的塞瓦斯托波尔附近没有赛车跑道，这虽令人失望但不是错误，返回此代码并附带搜索地点的链接和空的搜索结果列表。 |
| 服务器请求过载 | 503（Service Unavailable） | 服务器因请求过多无法处理特定请求时返回此代码，也可选择直接拒绝处理请求。 |
| 服务器功能异常 | 500（Internal Server Error） | 可能由于数据缺失、损坏、软件漏洞、硬件故障等原因导致，客户端对此无能为力，许多 Web 应用框架在服务器端出现异常时会自动发送此错误代码。 |

这个只读地图服务设计简单，客户端无需大量前期投入即可使用，符合 Web 哲学，可通过 Web 浏览器使用，具有 RESTful 和面向资源的特点，地址可寻址、无状态且连接良好。但它仅支持读取数据，客户端只能获取数据，无法上传自己