Places UI Kit: Một thư viện có thể sử dụng ngay, cung cấp không gian tuỳ chỉnh và kiểm soát cho nhà phát triển. Hãy dùng thử và chia sẻ ý kiến của bạn về trải nghiệm dùng Bộ giao diện người dùng.

Trang này được dịch bởi Cloud Translation API.

Polygons

Lớp Polyline

Lớp google.maps.Polyline

Đường nhiều đoạn là một lớp phủ tuyến tính gồm các đoạn đường thẳng được kết nối trên bản đồ.

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {Polyline} = await google.maps.importLibrary("maps").
Xem Thư viện trong Maps JavaScript API.

Hàm dựng
`Polyline`	`Polyline([opts])` Tham số: `opts`: `PolylineOptions optional` Tạo một đường nhiều đoạn bằng cách sử dụng `PolylineOptions` đã truyền. Tham số này chỉ định cả đường dẫn của đường nhiều đoạn và kiểu nét vẽ sẽ dùng khi vẽ đường nhiều đoạn. Bạn có thể truyền một mảng gồm các `LatLng` hoặc một `MVCArray` gồm các `LatLng` khi tạo một đường nhiều đoạn, mặc dù các mảng đơn giản sẽ được chuyển đổi thành `MVCArray` trong đường nhiều đoạn khi khởi tạo.

Hàm dựng

Polyline

Polyline([opts])

Tham số:

opts: PolylineOptions optional

Tạo một đường nhiều đoạn bằng cách sử dụng PolylineOptions đã truyền. Tham số này chỉ định cả đường dẫn của đường nhiều đoạn và kiểu nét vẽ sẽ dùng khi vẽ đường nhiều đoạn. Bạn có thể truyền một mảng gồm các LatLng hoặc một MVCArray gồm các LatLng khi tạo một đường nhiều đoạn, mặc dù các mảng đơn giản sẽ được chuyển đổi thành MVCArray trong đường nhiều đoạn khi khởi tạo.

Phương thức
`getDraggable`	`getDraggable()` Tham số: Không có Giá trị trả về: `boolean` Trả về liệu người dùng có thể kéo hình dạng này hay không.
`getEditable`	`getEditable()` Tham số: Không có Giá trị trả về: `boolean` Trả về xem người dùng có thể chỉnh sửa hình dạng này hay không.
`getMap`	`getMap()` Tham số: Không có Giá trị trả về: `Map\|null` Trả về bản đồ mà hình dạng này được đính kèm.
`getPath`	`getPath()` Tham số: Không có Giá trị trả về: `MVCArray<LatLng>` Truy xuất đường dẫn.
`getVisible`	`getVisible()` Tham số: Không có Giá trị trả về: `boolean` Trả về giá trị cho biết đa giác này có xuất hiện trên bản đồ hay không.
`setDraggable`	`setDraggable(draggable)` Tham số: `draggable`: `boolean` Giá trị trả về: Không có Nếu được đặt thành `true`, người dùng có thể kéo hình dạng này lên bản đồ. Thuộc tính `geodesic` xác định chế độ kéo.
`setEditable`	`setEditable(editable)` Tham số: `editable`: `boolean` Giá trị trả về: Không có Nếu được đặt thành `true`, người dùng có thể chỉnh sửa hình dạng này bằng cách kéo các điểm điều khiển xuất hiện tại các đỉnh và trên mỗi đoạn.
`setMap`	`setMap(map)` Tham số: `map`: `Map optional` Giá trị trả về: Không có Kết xuất hình dạng này trên bản đồ đã chỉ định. Nếu bạn đặt bản đồ thành `null`, hình dạng sẽ bị xoá.
`setOptions`	`setOptions(options)` Tham số: `options`: `PolylineOptions optional` Giá trị trả về: Không có
`setPath`	`setPath(path)` Tham số: `path`: `MVCArray<LatLng>\|Array<LatLng\|LatLngLiteral>` Giá trị trả về: Không có Đặt đường dẫn. Hãy xem `PolylineOptions` để biết thêm thông tin chi tiết.
`setVisible`	`setVisible(visible)` Tham số: `visible`: `boolean` Giá trị trả về: Không có Ẩn đa giác này nếu được đặt thành `false`.
Kế thừa: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Sự kiện
`click`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi sự kiện nhấp vào DOM được kích hoạt trên Polyline.
`contextmenu`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi sự kiện contextmenu DOM được kích hoạt trên Đa tuyến.
`dblclick`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này sẽ kích hoạt khi sự kiện dblclick DOM kích hoạt trên Polyline.
`drag`	`function(event)` Đối số: `event`: `MapMouseEvent` Sự kiện này được kích hoạt nhiều lần trong khi người dùng kéo đường nhiều đoạn.
`dragend`	`function(event)` Đối số: `event`: `MapMouseEvent` Sự kiện này được kích hoạt khi người dùng ngừng kéo đường nhiều đoạn.
`dragstart`	`function(event)` Đối số: `event`: `MapMouseEvent` Sự kiện này được kích hoạt khi người dùng bắt đầu kéo đường nhiều đoạn.
`mousedown`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi sự kiện mousedown DOM được kích hoạt trên Polyline.
`mousemove`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi sự kiện DOM mousemove được kích hoạt trên Polyline.
`mouseout`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi chuột di chuyển ra khỏi Đường nhiều đoạn.
`mouseover`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi di chuột lên Đường nhiều đoạn.
`mouseup`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi sự kiện DOM mouseup được kích hoạt trên Polyline.
`rightclick`	Không dùng nữa: Hãy sử dụng sự kiện `Polyline.contextmenu` để hỗ trợ các mẫu sử dụng như thao tác nhấp bằng tổ hợp phím control trên macOS. `function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi bạn nhấp chuột phải vào Polyline.

Giao diện PolylineOptions

google.maps.PolylineOptionsgiao diện

Đối tượng PolylineOptions dùng để xác định các thuộc tính có thể đặt trên một Polyline.

Thuộc tính
`clickable optional`	Loại: `boolean optional` Mặc định: `true` Cho biết liệu `Polyline` này có xử lý các sự kiện liên quan đến chuột hay không.
`draggable optional`	Loại: `boolean optional` Mặc định: `false` Nếu được đặt thành `true`, người dùng có thể kéo hình dạng này lên bản đồ. Thuộc tính `geodesic` xác định chế độ kéo.
`editable optional`	Loại: `boolean optional` Mặc định: `false` Nếu được đặt thành `true`, người dùng có thể chỉnh sửa hình dạng này bằng cách kéo các điểm điều khiển xuất hiện tại các đỉnh và trên mỗi đoạn.
`geodesic optional`	Loại: `boolean optional` Mặc định: `false` Khi `true`, các cạnh của đa giác được diễn giải là đường trắc địa và sẽ tuân theo độ cong của Trái Đất. Khi `false`, các cạnh của đa giác được kết xuất dưới dạng đường thẳng trong không gian màn hình. Xin lưu ý rằng hình dạng của một đa giác trắc địa có thể thay đổi khi bạn kéo, vì các phương diện được duy trì tương ứng với bề mặt trái đất.
`icons optional`	Loại: `Array<IconSequence> optional` Các biểu tượng sẽ được kết xuất dọc theo đường nhiều đoạn.
`map optional`	Loại: `Map optional` Bản đồ để hiển thị Polyline.
`path optional`	Loại: `MVCArray<LatLng>\|Array<LatLng\|LatLngLiteral> optional` Chuỗi toạ độ được sắp xếp của Polyline. Bạn có thể chỉ định đường dẫn này bằng cách sử dụng một mảng đơn giản gồm các `LatLng` hoặc một `MVCArray` gồm các `LatLng`. Xin lưu ý rằng nếu bạn truyền một mảng đơn giản, mảng đó sẽ được chuyển đổi thành một `MVCArray` Việc chèn hoặc xoá LatLng trong `MVCArray` sẽ tự động cập nhật đường nhiều đoạn trên bản đồ.
`strokeColor optional`	Loại: `string optional` Màu nét vẽ. Tất cả các màu CSS3 đều được hỗ trợ, ngoại trừ các màu có tên mở rộng.
`strokeOpacity optional`	Loại: `number optional` Độ mờ của nét vẽ trong khoảng từ 0,0 đến 1,0.
`strokeWeight optional`	Loại: `number optional` Độ rộng của nét vẽ tính bằng pixel.
`visible optional`	Loại: `boolean optional` Mặc định: `true` Đường nhiều đoạn này có xuất hiện trên bản đồ hay không.
`zIndex optional`	Loại: `number optional` zIndex so với các đa giác khác.

Giao diện IconSequence

google.maps.IconSequencegiao diện

Mô tả cách hiển thị các biểu tượng trên một dòng.

Nếu đường nhiều đoạn của bạn là đường trắc địa, thì khoảng cách được chỉ định cho cả độ lệch và số lần lặp lại sẽ được tính bằng mét theo mặc định. Việc đặt độ lệch hoặc lặp lại thành giá trị pixel sẽ khiến khoảng cách được tính bằng pixel trên màn hình.

Thuộc tính
`fixedRotation optional`	Loại: `boolean optional` Mặc định: `false` Nếu `true`, mỗi biểu tượng trong chuỗi đều có cùng độ xoay cố định, bất kể góc của cạnh mà biểu tượng nằm trên đó. Nếu `false`, trong trường hợp này, mỗi biểu tượng trong chuỗi sẽ được xoay để căn chỉnh với cạnh của biểu tượng đó.
`icon optional`	Loại: `Symbol optional` Biểu tượng cần hiển thị trên đường kẻ.
`offset optional`	Loại: `string optional` Mặc định: `'100%'` Khoảng cách từ điểm bắt đầu của đường mà tại đó biểu tượng sẽ được kết xuất. Khoảng cách này có thể được biểu thị bằng tỷ lệ phần trăm chiều dài của đường (ví dụ: "50%") hoặc bằng pixel (ví dụ: "50px").
`repeat optional`	Loại: `string optional` Mặc định: `0` Khoảng cách giữa các biểu tượng liên tiếp trên đường. Khoảng cách này có thể được biểu thị bằng tỷ lệ phần trăm chiều dài của đường (ví dụ: "50%") hoặc bằng pixel (ví dụ: "50px"). Để tắt chế độ lặp lại biểu tượng, hãy chỉ định giá trị "0".

Lớp Polygon

Lớp google.maps.Polygon

Đa giác (chẳng hạn như đường nhiều đoạn) xác định một chuỗi các toạ độ được kết nối theo một trình tự có thứ tự. Ngoài ra, đa giác tạo thành một vòng khép kín và xác định một vùng được tô màu. Hãy xem các mẫu trong hướng dẫn dành cho nhà phát triển, bắt đầu bằng một đa giác đơn giản, một đa giác có lỗ và nhiều mẫu khác. Xin lưu ý rằng bạn cũng có thể sử dụng Lớp dữ liệu để tạo một đa giác. Lớp Dữ liệu cung cấp một cách đơn giản hơn để tạo lỗ vì lớp này xử lý thứ tự của các đường dẫn bên trong và bên ngoài cho bạn.

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {Polygon} = await google.maps.importLibrary("maps").
Xem Thư viện trong Maps JavaScript API.

Hàm dựng
`Polygon`	`Polygon([opts])` Tham số: `opts`: `PolygonOptions optional` Tạo một đa giác bằng cách sử dụng `PolygonOptions` đã truyền. Tham số này chỉ định đường dẫn của đa giác, kiểu nét vẽ cho các cạnh của đa giác và kiểu tô màu cho các vùng bên trong của đa giác. Đa giác có thể chứa một hoặc nhiều đường dẫn, trong đó mỗi đường dẫn bao gồm một mảng `LatLng`. Bạn có thể truyền một mảng LatLng hoặc một `MVCArray` gồm các `LatLng` khi tạo các đường dẫn này. Các mảng được chuyển đổi thành `MVCArray` trong đa giác khi khởi tạo.

Hàm dựng

Polygon

Polygon([opts])

Tham số:

opts: PolygonOptions optional

Tạo một đa giác bằng cách sử dụng PolygonOptions đã truyền. Tham số này chỉ định đường dẫn của đa giác, kiểu nét vẽ cho các cạnh của đa giác và kiểu tô màu cho các vùng bên trong của đa giác. Đa giác có thể chứa một hoặc nhiều đường dẫn, trong đó mỗi đường dẫn bao gồm một mảng LatLng. Bạn có thể truyền một mảng LatLng hoặc một MVCArray gồm các LatLng khi tạo các đường dẫn này. Các mảng được chuyển đổi thành MVCArray trong đa giác khi khởi tạo.

Phương thức
`getDraggable`	`getDraggable()` Tham số: Không có Giá trị trả về: `boolean` Trả về liệu người dùng có thể kéo hình dạng này hay không.
`getEditable`	`getEditable()` Tham số: Không có Giá trị trả về: `boolean` Trả về xem người dùng có thể chỉnh sửa hình dạng này hay không.
`getMap`	`getMap()` Tham số: Không có Giá trị trả về: `Map\|null` Trả về bản đồ mà hình dạng này được đính kèm.
`getPath`	`getPath()` Tham số: Không có Giá trị trả về: `MVCArray<LatLng>` Truy xuất đường dẫn đầu tiên.
`getPaths`	`getPaths()` Tham số: Không có Giá trị trả về: `MVCArray<MVCArray<LatLng>>` Truy xuất các đường dẫn cho đa giác này.
`getVisible`	`getVisible()` Tham số: Không có Giá trị trả về: `boolean` Trả về giá trị cho biết đa giác này có xuất hiện trên bản đồ hay không.
`setDraggable`	`setDraggable(draggable)` Tham số: `draggable`: `boolean` Giá trị trả về: Không có Nếu được đặt thành `true`, người dùng có thể kéo hình dạng này lên bản đồ. Thuộc tính `geodesic` xác định chế độ kéo.
`setEditable`	`setEditable(editable)` Tham số: `editable`: `boolean` Giá trị trả về: Không có Nếu được đặt thành `true`, người dùng có thể chỉnh sửa hình dạng này bằng cách kéo các điểm điều khiển xuất hiện tại các đỉnh và trên mỗi đoạn.
`setMap`	`setMap(map)` Tham số: `map`: `Map optional` Giá trị trả về: Không có Kết xuất hình dạng này trên bản đồ đã chỉ định. Nếu bạn đặt bản đồ thành `null`, hình dạng sẽ bị xoá.
`setOptions`	`setOptions(options)` Tham số: `options`: `PolygonOptions optional` Giá trị trả về: Không có
`setPath`	`setPath(path)` Tham số: `path`: `MVCArray<LatLng>\|Array<LatLng\|LatLngLiteral>` Giá trị trả về: Không có Đặt đường dẫn đầu tiên. Hãy xem `PolygonOptions` để biết thêm thông tin chi tiết.
`setPaths`	`setPaths(paths)` Tham số: `paths`: `MVCArray<MVCArray<LatLng>>\|MVCArray<LatLng>\|Array<Array<LatLng\|LatLngLiteral>>\|Array<LatLng\|LatLngLiteral>` Giá trị trả về: Không có Đặt đường dẫn cho đa giác này.
`setVisible`	`setVisible(visible)` Tham số: `visible`: `boolean` Giá trị trả về: Không có Ẩn đa giác này nếu được đặt thành `false`.
Kế thừa: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Sự kiện
`click`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi sự kiện nhấp vào DOM được kích hoạt trên Đa giác.
`contextmenu`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi sự kiện contextmenu DOM được kích hoạt trên Đa giác.
`dblclick`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi sự kiện dblclick DOM được kích hoạt trên Đa giác.
`drag`	`function(event)` Đối số: `event`: `MapMouseEvent` Sự kiện này được kích hoạt nhiều lần trong khi người dùng kéo đa giác.
`dragend`	`function(event)` Đối số: `event`: `MapMouseEvent` Sự kiện này được kích hoạt khi người dùng ngừng kéo đa giác.
`dragstart`	`function(event)` Đối số: `event`: `MapMouseEvent` Sự kiện này được kích hoạt khi người dùng bắt đầu kéo đa giác.
`mousedown`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi sự kiện mousedown DOM được kích hoạt trên Đa giác.
`mousemove`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi sự kiện DOM mousemove được kích hoạt trên Đa giác.
`mouseout`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi Polygon mouseout.
`mouseover`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi di chuột lên Đa giác.
`mouseup`	`function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này được kích hoạt khi sự kiện DOM mouseup được kích hoạt trên Đa giác.
`rightclick`	Không dùng nữa: Hãy sử dụng sự kiện `Polygon.contextmenu` để hỗ trợ các mẫu sử dụng như thao tác nhấp bằng tổ hợp phím control trên macOS. `function(event)` Đối số: `event`: `PolyMouseEvent` Sự kiện này sẽ kích hoạt khi bạn nhấp chuột phải vào Đa giác.

Giao diện PolygonOptions

google.maps.PolygonOptionsgiao diện

Đối tượng PolygonOptions dùng để xác định các thuộc tính có thể đặt trên một Đa giác.

Thuộc tính
`clickable optional`	Loại: `boolean optional` Mặc định: `true` Cho biết liệu `Polygon` này có xử lý các sự kiện liên quan đến chuột hay không.
`draggable optional`	Loại: `boolean optional` Mặc định: `false` Nếu được đặt thành `true`, người dùng có thể kéo hình dạng này lên bản đồ. Thuộc tính `geodesic` xác định chế độ kéo.
`editable optional`	Loại: `boolean optional` Mặc định: `false` Nếu được đặt thành `true`, người dùng có thể chỉnh sửa hình dạng này bằng cách kéo các điểm điều khiển xuất hiện tại các đỉnh và trên mỗi đoạn.
`fillColor optional`	Loại: `string optional` Màu nền. Tất cả các màu CSS3 đều được hỗ trợ, ngoại trừ các màu có tên mở rộng.
`fillOpacity optional`	Loại: `number optional` Độ mờ của màu tô trong khoảng từ 0,0 đến 1,0
`geodesic optional`	Loại: `boolean optional` Mặc định: `false` Khi `true`, các cạnh của đa giác được diễn giải là đường trắc địa và sẽ tuân theo độ cong của Trái Đất. Khi `false`, các cạnh của đa giác được kết xuất dưới dạng đường thẳng trong không gian màn hình. Xin lưu ý rằng hình dạng của một đa giác trắc địa có thể thay đổi khi bạn kéo, vì các phương diện được duy trì tương ứng với bề mặt trái đất.
`map optional`	Loại: `Map optional` Bản đồ mà bạn muốn hiển thị Đa giác.
`paths optional`	Loại: `MVCArray<MVCArray<LatLng>>\|MVCArray<LatLng>\|Array<Array<LatLng\|LatLngLiteral>>\|Array<LatLng\|LatLngLiteral> optional` Chuỗi toạ độ có thứ tự chỉ định một vòng khép kín. Không giống như đường nhiều đoạn, một đa giác có thể bao gồm một hoặc nhiều đường dẫn. Do đó, thuộc tính paths có thể chỉ định một hoặc nhiều mảng gồm các toạ độ `LatLng`. Đường dẫn sẽ tự động đóng; không lặp lại đỉnh đầu tiên của đường dẫn làm đỉnh cuối cùng. Bạn có thể xác định các đa giác đơn giản bằng cách sử dụng một mảng duy nhất gồm các `LatLng`. Các đa giác phức tạp hơn có thể chỉ định một mảng các mảng. Mọi mảng đơn giản đều được chuyển đổi thành `MVCArray`. Việc chèn hoặc xoá `LatLng` khỏi `MVCArray` sẽ tự động cập nhật đa giác trên bản đồ.
`strokeColor optional`	Loại: `string optional` Màu nét vẽ. Tất cả các màu CSS3 đều được hỗ trợ, ngoại trừ các màu có tên mở rộng.
`strokeOpacity optional`	Loại: `number optional` Độ mờ của nét vẽ trong khoảng từ 0,0 đến 1,0
`strokePosition optional`	Loại: `StrokePosition optional` Mặc định: `StrokePosition.CENTER` Vị trí nét vẽ.
`strokeWeight optional`	Loại: `number optional` Độ rộng của nét vẽ tính bằng pixel.

Polygons Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Lớp Polyline

Hàm dựng

Phương thức

Sự kiện

Giao diện PolylineOptions

Thuộc tính

Giao diện IconSequence

Thuộc tính

Lớp Polygon

Hàm dựng

Phương thức

Sự kiện

Giao diện PolygonOptions

Thuộc tính

Polygons