Merge pull request #70 from AmyYH/branch-0.3.x

EN translation of files under doc-en/source/restful.

Author: neza2017

doc-cn/source/restful/restful_config.md

@@ -9,7 +9,7 @@
 
         > **注意：** 
         > * 在 local 模式下，Spark 在一个物理节点内运行。配置示例如 `--interpreter_master=local[8]`，其中 `[8]` 表示使用 8 个 CPU。
-        > * 在 standalone 模式下，你需要指定 maseter url。配置示例如 `--interpreter_master=spark://IP:PORT`。
+        > * 在 standalone 模式下，你需要指定 master url。配置示例如 `--interpreter_master=spark://IP:PORT`。
         
     - `interpreter_pyspark_python`： Spark executor 的 Python 解释器的绝对路径。
     - `interpreter_pyspark_driver_python`： Spark driver 的 Python 解释器的绝对路径。

doc-en/source/restful/api/function/choroplethmap.md

@@ -1,6 +1,6 @@
-# Choropleth map
+# Choropleth Map
 
-Draws the choropleth map according to the relevant parameters and returns a Base64 image.
+Draws a choropleth map according to the relevant drawing parameters and returns the map in Base64 format.
 
 ## Request description
 
@@ -14,22 +14,22 @@ Draws the choropleth map according to the relevant parameters and returns a Base
 
 Parameter description:
 
-- `input_data`: 输入数据描述，需为已定义的变量名称或可执行的 Python 语句。
-    - `region_boundaries`: 轮廓的位置，格式为 WKB 的 pandas.Series。
-    - `weights`: 轮廓权重，为 float64 或 int64 类型的 pandas.Series。
-- `params`: 绘图参数。
-    - `width`: 图片宽度。
-    - `height`: 图片高度。
-    - `bounding_box`: 渲染图片所表示的地理范围 [x_min, y_min, x_max, y_max]。
-    - `coordinate_system`: 输入数据的坐标系统，详见 [World Geodetic System](https://en.wikipedia.org/wiki/World_Geodetic_System)。
-    - `color_gradient`: 轮廓的颜色渐变范围，即轮廓的颜色从左边渐变到右边。
-    - `color_bound`: 轮廓颜色的取值范围，与 `color_gradient` 配合使用。
-    - `opacity`: 轮廓的不透明度。
-    - `aggregation_type`: 聚合类型。
+- `input_data`: Description of input data. Needs to be the names of the defined variables or executable Python statements.
+    - `region_boundaries`: Location of the contour, which is pandas.Series in WKB format.
+    - `weights`: Weight of the contour, which is pandas.Series of float64 type or int64 type.
+- `params`: Drawing parameters.
+    - `width`: Width of the image.
+    - `height`: Height of the image.
+    - `bounding_box`: Geographic extent represented by the rendered image [x_min, y_min, x_max, y_max].
+    - `coordinate_system`: Coordinate system of the input data. See [World Geodetic System](https://en.wikipedia.org/wiki/World_Geodetic_System) for more information.
+    - `color_gradient`: The color gradient range of the contour, that is, the color of the contour is gradient from the left to the right.
+    - `color_bound`: Value range of the contour color, used together with `color_gradient`.
+    - `opacity`: Opacity of the contour.
+    - `aggregation_type`: Aggregation type.
 
 ### Python backend
 
-The example for Python backend is as follows:
+A JSON example for the Python backend is as follows:
 
 ```json
 {
@@ -52,7 +52,7 @@ The example for Python backend is as follows:
 
 ### PySpark backend
 
-If you use the PySpark backend, you only need to change the `input_data` in the example of Python backend to the following SQL query:
+If you use the PySpark backend, you only need to change the `input_data` in the above example for Python backend to the corresponding SQL query. See the following example:
 
 ```
 "sql": "select ST_GeomFromText(buildingtext_pickup) as polygon, fare_amount as count from raw_data where buildingtext_pickup!=''"
@@ -62,13 +62,13 @@ If you use the PySpark backend, you only need to change the `input_data` in the
 
 ### Python
 
-The example uses Python's `requests` library to call `Arctern RESTful API`. Run the following command to install `requests`:
+Examples in this article use Python's `requests` library. Run the following command to install `requests`:
 
 ```bash
 pip install requests
 ```
 
-Here is an example of calling the `choroplethmap` API:
+Sample code:
 
 ```python
 import requests
@@ -130,6 +130,6 @@ curl --location --request POST 'http://localhost:8080/choroplethmap' \
 {
     "status": "success",
     "code": "200",
-    "result": "使用 Base64 编码后的轮廓图数据"
+    "result": "Base64-encoded choropleth map data"
 }
 ```

doc-en/source/restful/api/function/command.md

@@ -1,6 +1,6 @@
-# Run codes
+# Code Execution
 
-执行给定的 Python 代码。
+Executes a given Python code.
 
 ## Request description
 
@@ -18,19 +18,19 @@
 
     Parameter description:
 
-    - `command`: 待执行的 Python 代码。
+    - `command`: The Python code to execute.
 
 ## Request example
 
 ### Python
 
-The example uses Python's `requests` library to call `Arctern RESTful API`. Run the following command to install `requests`:
+Examples in this article use Python's `requests` library. Run the following command to install `requests`:
 
 ```bash
 pip install requests
 ```
 
-Here is an example of calling the `command` API:
+Sample code:
 
 ```python
 import requests

doc-en/source/restful/api/function/fishnetmap.md

@@ -1,36 +1,36 @@
-# Fishnet map
+# Fishnet Map
 
-根据相关画图参数绘制渔网图，将绘图结果以 Base64 编码方式返回。
+Draws a fishnet map according to the relevant drawing parameters and returns the map in Base64 format.
 
 ## Request description
 
 - Method: `POST`
 - URL: `/fishnetmap`
 - Headers:
     - `Content-Type: application/json`
-- Body: See [Body example](#Body-example)。
+- Body: See [Body example](#Body-example).
 
 ## Body example
 
 Parameter description:
 
-- `input_data`: 输入数据描述，需为已定义的变量名称或可执行的 Python 语句。
-    - `points`: 渔网网格的位置，格式为 WKB 的 pandas.Series。
-    - `weights`: 渔网网格的权重，为 float64 或 int64 类型的 pandas.Series。
-- `params`: 绘图参数。
-    - `width`: 图片宽度。
-    - `height`: 图片高度。
-    - `bounding_box`: 渲染图片所表示的地理范围 [x_min, y_min, x_max, y_max]。
-    - `coordinate_system`: 输入数据的坐标系统，详见 [World Geodetic System](https://en.wikipedia.org/wiki/World_Geodetic_System)。
-    - `color_gradient`: 渔网网格的颜色渐变范围，目前仅支持默认值 ["#0000FF", "#FF0000"]。
-    - `cell_size`: 渔网网格的边长。
-    - `cell_spacing`: 渔网网格之间的间隔。
-    - `opacity`: 渔网网格的不透明度。
-    - `aggregation_type`: 聚合类型。
+- `input_data`: Description of input data. Needs to be the names of the defined variables or executable Python statements.
+    - `points`: Location of the fishnet cell, which is pandas.Series in WKB format.
+    - `weights`: Weight of the fishnet cell, which is pandas.Series of float64 type or int64 type.
+- `params`: Drawing parameters.
+    - `width`: Width of the image.
+    - `height`: Height of the image.
+    - `bounding_box`: Geographic extent represented by the rendered image [x_min, y_min, x_max, y_max].
+    - `coordinate_system`: Coordinate system of the input data. See [World Geodetic System](https://en.wikipedia.org/wiki/World_Geodetic_System) for more information.
+    - `color_gradient`: The color gradient range of the fishnet cell. Supports the default value ["#0000FF", "#FF0000"] only.
+    - `cell_size`: Size of the fishnet cell.
+    - `cell_spacing`: Spacing between fishnet cells.
+    - `opacity`: Opacity of the fishnet cell.
+    - `aggregation_type`: Aggregation type.
 
 ### Python backend
 
-The example for Python backend is as follows:
+A JSON example for the Python backend is as follows:
 
 ```json
 {
@@ -54,7 +54,7 @@ The example for Python backend is as follows:
 
 ### PySpark backend
 
-If you use the PySpark backend, you only need to change the `input_data` in the example of Python backend to the following SQL query:
+If you use the PySpark backend, you only need to change the `input_data` in the above example to the corresponding SQL query. See the following example:
 
 ```
 "sql": "select ST_Point(pickup_longitude, pickup_latitude) as point, fare_amount as count from raw_data"
@@ -64,13 +64,13 @@ If you use the PySpark backend, you only need to change the `input_data` in the
 
 ### Python
 
-The example uses Python's `requests` library to call `Arctern RESTful API`. Run the following command to install `requests`:
+Examples in this article use Python's `requests` library. Run the following command to install `requests`:
 
 ```bash
 pip install requests
 ```
 
-Here is an example of calling the `fishnetmap` API:
+Sample code:
 
 ```python
 import requests
@@ -134,6 +134,6 @@ curl --location --request POST 'http://localhost:8080/fishnetmap' \
 {
     "status": "success",
     "code": "200",
-    "result": "使用 Base64 编码后的渔网图数据"
+    "result": "Base64-encoded fishnet map data"
 }
 ```

doc-en/source/restful/api/function/heatmap.md

@@ -1,33 +1,33 @@
-# Heat map
+# Heat Map
 
-根据相关画图参数绘制热力图，将绘图结果以 Base64 编码方式返回。
+Draws a heat map according to the relevant drawing parameters and returns the map in Base64 format.
 
 ## Request description
 
 - Method: `POST`
 - URL: `/heatmap`
 - Headers:
     - `Content-Type: application/json`
-- Body: See [Body example](#Body-example)。
+- Body: See [Body example](#Body-example).
 
 ## Body example
 
 Parameter description:
 
-- `input_data`: 输入数据描述，需为已定义的变量名称或可执行的 Python 语句。
-    - `points`: 点的位置，格式为 WKB 的 pandas.Series。
-    - `weights`: 热力值，为 float64 或 int64 类型的 pandas.Series。
-- `params`: 绘图参数。
-    - `width`: 图片宽度。
-    - `height`: 图片高度。
-    - `bounding_box`: 渲染图片所表示的地理范围 [x_min, y_min, x_max, y_max]。
-    - `coordinate_system`: 输入数据的坐标系统，详见 [World Geodetic System](https://en.wikipedia.org/wiki/World_Geodetic_System)。
-    - `map_zoom_level`: 地图放大比例，取值范围 [1, 15]。
-    - `aggregation_type`: 聚合类型。
+- `input_data`: Description of input data. Needs to be the names of the defined variables or executable Python statements.
+    - `points`: Location of the point, which is pandas.Series in WKB format.
+    - `weights`: Heat value, which is pandas.Series of float64 type or int64 type.
+- `params`: Drawing parameters.
+    - `width`: Width of the image.
+    - `height`: Height of the image.
+    - `bounding_box`: Geographic extent represented by the rendered image [x_min, y_min, x_max, y_max].
+    - `coordinate_system`: Coordinate system of the input data. See [World Geodetic System](https://en.wikipedia.org/wiki/World_Geodetic_System) for more information.
+    - `map_zoom_level`: Zoom level of the map, in the range of [1, 15].
+    - `aggregation_type`: Aggregation type.
 
 ### Python backend
 
-The example for Python backend is as follows:
+A JSON example for the Python backend is as follows:
 
 ```json
 {
@@ -48,7 +48,7 @@ The example for Python backend is as follows:
 
 ### PySpark backend
 
-If you use the PySpark backend, you only need to change the `input_data` in the example of Python backend to the following SQL query:
+If you use the PySpark backend, you only need to change the `input_data` in the above example for Python backend to the corresponding SQL query. See the following example:
 
 ```
 "sql": "select ST_Point(pickup_longitude, pickup_latitude) as point, fare_amount as weights from raw_data"
@@ -58,13 +58,13 @@ If you use the PySpark backend, you only need to change the `input_data` in the
 
 ### Python
 
-The example uses Python's `requests` library to call `Arctern RESTful API`. Run the following command to install `requests`:
+Examples in this article use Python's `requests` library. Run the following command to install `requests`:
 
 ```bash
 pip install requests
 ```
 
-Here is an example of calling the `heatmap` API:
+Sample code:
 
 ```python
 import requests
@@ -122,6 +122,6 @@ curl --location --request POST 'http://localhost:8080/heatmap' \
 {
     "status": "success",
     "code": "200",
-    "result": "使用 Base64 编码后的热力图数据"
+    "result": "Base64-encoded heat map data"
 }
 ```

doc-en/source/restful/api/function/icon_viz.md

@@ -1,31 +1,31 @@
-# Icon map
+# Icon Map
 
-根据相关画图参数绘制图标图，将绘图结果以 Base64 编码方式返回。
+Draws an icon map according to the relevant drawing parameters and returns the map in Base64 format.
 
 ## Request description
 
 - Method: `POST`
 - URL: `/icon_viz`
 - Headers:
     - `Content-Type: application/json`
-- Body: See [Body example](#Body-example)。
+- Body: See [Body example](#Body-example).
 
 ## Body example
 
 Parameter description:
 
-- `input_data`: 输入数据描述，需为已定义的变量名称或可执行的 Python 语句。
-    - `points`: 点的位置，格式为 WKB 的 pandas.Series。
-- `params`: 绘图参数。
-    - `width`: 图片宽度。
-    - `height`: 图片高度。
-    - `bounding_box`: 渲染图片所表示的地理范围 [x_min, y_min, x_max, y_max]。
-    - `icon_path`: png 图标文件的绝对路径。
-    - `coordinate_system`: 输入数据的坐标系统，详见 [World Geodetic System](https://en.wikipedia.org/wiki/World_Geodetic_System)。
+- `input_data`: Description of input data. Needs to be the names of the defined variables or executable Python statements.
+    - `points`: Location of points, which is pandas.Series in WKB format.
+- `params`: Drawing parameters.
+    - `width`: Width of the image.
+    - `height`: Height of the image.
+    - `bounding_box`: Geographic extent represented by the rendered image [x_min, y_min, x_max, y_max].
+    - `icon_path`: Absolute path to the icon file in PNG format.
+    - `coordinate_system`: Coordinate system of the input data. See [World Geodetic System](https://en.wikipedia.org/wiki/World_Geodetic_System) for more information.
 
 ### Python backend
 
-The example for Python backend is as follows:
+A JSON example for the Python backend is as follows:
 
 ```json
 {
@@ -44,7 +44,7 @@ The example for Python backend is as follows:
 
 ### PySpark backend
 
-If you use the PySpark backend, you only need to change the `input_data` in the example of Python backend to the following SQL query:
+If you use the PySpark backend, you only need to change the `input_data` in the above example for Python backend to the corresponding SQL query. See the following example:
 
 ```
 "sql": "select ST_Point(pickup_longitude, pickup_latitude) as point from raw_data"
@@ -54,13 +54,13 @@ If you use the PySpark backend, you only need to change the `input_data` in the
 
 ### Python
 
-The example uses Python's `requests` library to call `Arctern RESTful API`. Run the following command to install `requests`:
+Examples in this article use Python's `requests` library. Run the following command to install `requests`:
 
 ```bash
 pip install requests
 ```
 
-Here is an example of calling the `icon_viz` API:
+Sample code:
 
 ```python
 import requests
@@ -114,6 +114,6 @@ curl --location --request POST 'http://localhost:8080/icon_viz' \
 {
     "status": "success",
     "code": "200",
-    "result": "使用 Base64 编码后的图标图数据"
+    "result": "Base64-encoded icon map data"
 }
 ```