Coordinates

Lớp LatLng

google.maps.LatLng lớp
thư viện "core"

LatLng là một điểm trong toạ độ địa lý: vĩ độ và kinh độ.

• Vĩ độ nằm trong khoảng từ -90 đến 90 độ. Các giá trị nằm ngoài phạm vi này sẽ được giới hạn trong phạm vi [-90, 90]. Điều này có nghĩa là nếu giá trị được chỉ định nhỏ hơn -90, thì giá trị đó sẽ được đặt thành -90. Nếu giá trị lớn hơn 90, thì giá trị này sẽ được đặt thành 90.
• Kinh độ nằm trong khoảng từ -180 đến 180 độ. Các giá trị nằm ngoài phạm vi này sẽ được điều chỉnh để nằm trong phạm vi. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 190 sẽ được chuyển đổi thành -170. Điều này phản ánh thực tế là kinh độ bao quanh địa cầu.

Mặc dù phép chiếu bản đồ mặc định liên kết kinh độ với toạ độ x của bản đồ và vĩ độ với toạ độ y, nhưng toạ độ vĩ độ luôn được viết trước, sau đó mới đến kinh độ.
Xin lưu ý rằng bạn không thể sửa đổi toạ độ của LatLng. Nếu muốn tính toán một điểm khác, bạn phải tạo một điểm mới.

Hầu hết các phương thức chấp nhận đối tượng LatLng cũng chấp nhận đối tượng LatLngLiteral, vì vậy, các phương thức sau đây là tương đương:

 map.setCenter(new google.maps.LatLng(-34, 151));
 map.setCenter({lat: -34, lng: 151}); 

Hàm khởi tạo cũng chấp nhận các đối tượng LatLngLiteral và LatLng. Nếu một thực thể LatLng được truyền đến hàm khởi tạo, thì một bản sao sẽ được tạo.

Dưới đây là các lệnh gọi có thể thực hiện đến hàm khởi tạo:

 new google.maps.LatLng(-34, 151);
 new google.maps.LatLng(-34, 151, true);
 new google.maps.LatLng({lat: -34, lng: 151});
 new google.maps.LatLng({lat: -34, lng: 151}, true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
 

const {LatLng} = await google.maps.importLibrary("core");

Hàm dựng

LatLng

LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap]) Tham số: latOrLatLngOrLatLngLiteral: number|LatLngLiteral|LatLng lngOrNoClampNoWrap: number|boolean optional noClampNoWrap: boolean optional Tạo một đối tượng LatLng đại diện cho một điểm địa lý. Vĩ độ được chỉ định theo độ trong khoảng [-90, 90]. Kinh độ được chỉ định theo độ trong phạm vi [-180, 180). Đặt noClampNoWrap thành true để bật các giá trị nằm ngoài phạm vi này. Lưu ý thứ tự của vĩ độ và kinh độ.

Phương thức
equals	equals(other) Tham số: other: LatLng|LatLngLiteral optional Giá trị trả về: boolean Hàm so sánh cho hai LatLng. Trả về true nếu các toạ độ nằm trong khoảng 1e-9 của nhau và false nếu không.
lat	lat() Tham số: Không có Giá trị trả về: number Trả về vĩ độ theo độ.
lng	lng() Tham số: Không có Giá trị trả về: number Trả về kinh độ theo độ.
toJSON	toJSON() Tham số: Không có Giá trị trả về: LatLngLiteral Chuyển đổi sang dạng biểu diễn JSON. Hàm này được dùng thông qua JSON.stringify.
toString	toString() Tham số: Không có Giá trị trả về: string Chuyển đổi thành biểu thị chuỗi.
toUrlValue	toUrlValue([precision]) Tham số: precision: number optional Giá trị trả về: string Trả về một chuỗi có dạng "lat,lng" cho LatLng này. Theo mặc định, chúng tôi làm tròn các giá trị vĩ độ/kinh độ đến 6 chữ số thập phân.

Giao diện LatLngLiteral

google.maps.LatLngLiteral giao diện

Đối tượng chữ được chấp nhận thay cho đối tượng LatLng, để thuận tiện, ở nhiều nơi. Các đối tượng này được chuyển đổi thành đối tượng LatLng khi API Maps gặp chúng.

Ví dụ:

 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map}); 

Thư viện Hình học không hỗ trợ đối tượng chữ LatLng.

Thuộc tính
lat	Loại: number Vĩ độ tính bằng độ. Các giá trị sẽ được giới hạn trong phạm vi [-90, 90]. Điều này có nghĩa là nếu giá trị được chỉ định nhỏ hơn -90, thì giá trị đó sẽ được đặt thành -90. Nếu giá trị lớn hơn 90, thì giá trị này sẽ được đặt thành 90.
lng	Loại: number Kinh độ tính bằng độ. Các giá trị nằm ngoài phạm vi [-180, 180] sẽ được gói lại để nằm trong phạm vi này. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 190 sẽ được chuyển đổi thành -170. Điều này phản ánh thực tế là kinh độ bao quanh địa cầu.

Lớp LatLngBounds

google.maps.LatLngBounds lớp
thư viện "core"

Một thực thể LatLngBounds đại diện cho một hình chữ nhật trong toạ độ địa lý, bao gồm cả một hình chữ nhật vượt qua kinh tuyến 180 độ.

const {LatLngBounds} = await google.maps.importLibrary("core");

Hàm dựng
LatLngBounds	LatLngBounds([swOrLatLngBounds, ne]) Tham số: swOrLatLngBounds: LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne: LatLng|LatLngLiteral optional Tạo một hình chữ nhật từ các điểm ở góc tây nam và đông bắc.

Hằng số
MAX_BOUNDS	LatLngBounds cho ranh giới tối đa của Trái Đất. Các ranh giới này sẽ bao gồm toàn bộ địa cầu.

Phương thức
contains	contains(latLng) Tham số: latLng: LatLng|LatLngLiteral Giá trị trả về: boolean Trả về true nếu vĩ độ/kinh độ đã cho nằm trong giới hạn này.
equals	equals(other) Tham số: other: LatLngBounds|LatLngBoundsLiteral optional Giá trị trả về: boolean Trả về true nếu ranh giới này gần bằng ranh giới đã cho.
extend	extend(point) Tham số: point: LatLng|LatLngLiteral Giá trị trả về: LatLngBounds Mở rộng ranh giới này để chứa điểm đã cho.
getCenter	getCenter() Tham số: Không có Giá trị trả về: LatLng Tính tâm của LatLngBounds này
getNorthEast	getNorthEast() Tham số: Không có Giá trị trả về: LatLng Trả về góc đông bắc của ranh giới này.
getSouthWest	getSouthWest() Tham số: Không có Giá trị trả về: LatLng Trả về góc tây nam của ranh giới này.
intersects	intersects(other) Tham số: other: LatLngBounds|LatLngBoundsLiteral Giá trị trả về: boolean Trả về true nếu ranh giới này có chung điểm với ranh giới khác.
isEmpty	isEmpty() Tham số: Không có Giá trị trả về: boolean Trả về nếu các giới hạn trống.
toJSON	toJSON() Tham số: Không có Giá trị trả về: LatLngBoundsLiteral Chuyển đổi sang dạng biểu diễn JSON. Hàm này được dùng thông qua JSON.stringify.
toSpan	toSpan() Tham số: Không có Giá trị trả về: LatLng Chuyển đổi ranh giới bản đồ đã cho thành một dải vĩ độ/kinh độ.
toString	toString() Tham số: Không có Giá trị trả về: string Chuyển đổi thành chuỗi.
toUrlValue	toUrlValue([precision]) Tham số: precision: number optional Giá trị trả về: string Trả về một chuỗi có dạng "lat_lo,lng_lo,lat_hi,lng_hi" cho các ranh giới này, trong đó "lo" tương ứng với góc tây nam của hộp giới hạn, còn "hi" tương ứng với góc đông bắc của hộp đó.
union	union(other) Tham số: other: LatLngBounds|LatLngBoundsLiteral Giá trị trả về: LatLngBounds Mở rộng ranh giới này để chứa hợp của ranh giới này và ranh giới đã cho.

Giao diện LatLngBoundsLiteral

google.maps.LatLngBoundsLiteral giao diện

Đối tượng chữ được chấp nhận thay cho đối tượng LatLngBounds trong toàn bộ API. Các đối tượng này được tự động chuyển đổi thành đối tượng LatLngBounds. Bạn phải đặt tất cả south, west, north và east, nếu không, hệ thống sẽ gửi một trường hợp ngoại lệ.

Thuộc tính
east	Loại: number Kinh độ đông tính bằng độ. Các giá trị nằm ngoài phạm vi [-180, 180] sẽ được gói vào phạm vi [-180, 180). Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 190 sẽ được chuyển đổi thành -170. Điều này phản ánh thực tế là kinh độ bao quanh địa cầu.
north	Loại: number Vĩ độ bắc tính bằng độ. Các giá trị sẽ được giới hạn trong phạm vi [-90, 90]. Điều này có nghĩa là nếu giá trị được chỉ định nhỏ hơn -90, thì giá trị đó sẽ được đặt thành -90. Nếu giá trị lớn hơn 90, thì giá trị này sẽ được đặt thành 90.
south	Loại: number Vĩ độ nam tính bằng độ. Các giá trị sẽ được giới hạn trong phạm vi [-90, 90]. Điều này có nghĩa là nếu giá trị được chỉ định nhỏ hơn -90, thì giá trị đó sẽ được đặt thành -90. Nếu giá trị lớn hơn 90, thì giá trị này sẽ được đặt thành 90.
west	Loại: number Kinh độ tây tính bằng độ. Các giá trị nằm ngoài phạm vi [-180, 180] sẽ được gói vào phạm vi [-180, 180). Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 190 sẽ được chuyển đổi thành -170. Điều này phản ánh thực tế là kinh độ bao quanh địa cầu.

Lớp LatLngAltitude

google.maps.LatLngAltitude class
implements LatLngAltitudeLiteral, LatLngLiteral
library "core"

LatLngAltitude là một điểm 3D trong toạ độ địa lý: vĩ độ, kinh độ và độ cao.

• Vĩ độ nằm trong khoảng từ -90 đến 90 độ. Các giá trị nằm ngoài phạm vi này sẽ được giới hạn trong phạm vi [-90, 90]. Điều này có nghĩa là nếu giá trị được chỉ định nhỏ hơn -90, thì giá trị đó sẽ được đặt thành -90. Nếu giá trị lớn hơn 90, thì giá trị này sẽ được đặt thành 90.
• Kinh độ nằm trong khoảng từ -180 đến 180 độ. Các giá trị nằm ngoài phạm vi này sẽ được điều chỉnh để nằm trong phạm vi. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 190 sẽ được chuyển đổi thành -170. Điều này phản ánh thực tế là kinh độ bao quanh địa cầu.
• Độ cao được đo bằng mét. Giá trị dương biểu thị độ cao so với mặt đất và giá trị âm biểu thị độ cao dưới mặt đất.

const {LatLngAltitude} = await google.maps.importLibrary("core");

Hàm dựng

LatLngAltitude

LatLngAltitude(value[, noClampNoWrap]) Tham số: value: LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Giá trị khởi tạo. noClampNoWrap: boolean optional Có giữ nguyên các giá trị khởi tạo hay không, ngay cả khi các giá trị đó không nhất thiết phải là giá trị vĩ độ hợp lệ trong phạm vi [-90, 90] hoặc giá trị kinh độ hợp lệ trong phạm vi [-180, 180]. Giá trị mặc định là false, cho phép kẹp vĩ độ và gói kinh độ.

Thuộc tính
altitude readonly	Loại: number Trả về độ cao.
lat readonly	Loại: number Trả về vĩ độ.
lng readonly	Loại: number Trả về kinh độ.

Phương thức
equals	equals(other) Tham số: other: LatLngAltitude|LatLngAltitudeLiteral optional Một đối tượng LatLngAltitude khác. Giá trị trả về: boolean Cho biết hai đối tượng có bằng nhau hay không. Hàm so sánh cho hai LatLngAltitude. Trả về true nếu các toạ độ nằm trong khoảng 1e-9 của nhau và false nếu không.
toJSON	toJSON([key]) Tham số: key: string optional Giá trị trả về: LatLngAltitudeLiteral Chuyển đổi thành một đối tượng thuần tuý.

Giao diện LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interface
extends LatLngLiteral

Đối tượng chữ được chấp nhận thay cho đối tượng LatLngAltitude, để thuận tiện, ở nhiều nơi. Các đối tượng này được chuyển đổi thành đối tượng LatLngAltitude khi API Maps gặp chúng.

Thuộc tính
altitude	Loại: number Khoảng cách (tính bằng mét) so với mặt đất. Giá trị âm có nghĩa là bên dưới bề mặt mặt đất.
lat	Loại: number Vĩ độ tính bằng độ. Các giá trị sẽ được giới hạn trong phạm vi [-90, 90]. Điều này có nghĩa là nếu giá trị được chỉ định nhỏ hơn -90, thì giá trị đó sẽ được đặt thành -90. Nếu giá trị lớn hơn 90, thì giá trị này sẽ được đặt thành 90.
lng	Loại: number Kinh độ tính bằng độ. Các giá trị nằm ngoài phạm vi [-180, 180] sẽ được gói lại để nằm trong phạm vi này. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 190 sẽ được chuyển đổi thành -170. Điều này phản ánh thực tế là kinh độ bao quanh địa cầu.

Lớp Point

google.maps.Point lớp
thư viện "core"

const {Point} = await google.maps.importLibrary("core");

Hàm dựng
Point	Point(x, y) Tham số: x: number y: number Một điểm trên mặt phẳng hai chiều.

Thuộc tính
x	Loại: number Toạ độ X
y	Loại: number Toạ độ Y

Phương thức
equals	equals(other) Tham số: other: Point optional Giá trị trả về: boolean So sánh hai Điểm
toString	toString() Tham số: Không có Giá trị trả về: string Trả về một chuỗi đại diện cho Điểm này.

Lớp Size

google.maps.Size lớp
thư viện "core"

const {Size} = await google.maps.importLibrary("core");

Hàm dựng
Size	Size(width, height[, widthUnit, heightUnit]) Tham số: width: number height: number widthUnit: string optional heightUnit: string optional Kích thước hai chiều, trong đó chiều rộng là khoảng cách trên trục x và chiều cao là khoảng cách trên trục y.

Thuộc tính
height	Loại: number Chiều cao dọc theo trục y, tính bằng pixel.
width	Loại: number Chiều rộng dọc theo trục x, tính bằng pixel.

Phương thức
equals	equals(other) Tham số: other: Size optional Giá trị trả về: boolean So sánh hai Kích thước.
toString	toString() Tham số: Không có Giá trị trả về: string Trả về một chuỗi đại diện cho Kích thước này.

Khoảng đệm giao diện

google.maps.Padding giao diện

Thuộc tính
bottom không bắt buộc	Loại: number optional Khoảng đệm cho phần dưới cùng, tính bằng pixel.
left không bắt buộc	Loại: number optional Khoảng đệm cho bên trái, tính bằng pixel.
right không bắt buộc	Loại: number optional Khoảng đệm bên phải, tính bằng pixel.
top không bắt buộc	Loại: number optional Khoảng đệm cho phần trên cùng, tính bằng pixel.

Giao diện CircleLiteral

google.maps.CircleLiteral interface
extends CircleOptions

Đối tượng chữ đại diện cho một hình tròn.

Thuộc tính
center	Loại: LatLng|LatLngLiteral Tâm của hình tròn.
radius	Loại: number Bán kính tính bằng mét trên bề mặt Trái Đất.
Kế thừa: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex

Lớp Orientation3D

google.maps.Orientation3D class
implements Orientation3DLiteral
library "core"

Orientation3D là một vectơ ba chiều dùng cho các phép biến đổi xoay toán học chuẩn theo hướng, độ nghiêng và độ lăn.

• heading là một góc trong khoảng [0, 360) độ.
• độ nghiêng là một góc trong khoảng [0, 360) độ.
• roll là một góc trong khoảng [0, 360) độ.

const {Orientation3D} = await google.maps.importLibrary("core");

Hàm dựng
Orientation3D	Orientation3D(value) Tham số: value: Orientation3D|Orientation3DLiteral Giá trị khởi tạo.

Thuộc tính
heading readonly	Loại: number Mặc định: 0 Xoay quanh trục z (vuông góc với bề mặt Trái Đất). Giá trị 0 (mặc định) tương đương với hướng Bắc. Góc xoay dương là góc xoay theo chiều kim đồng hồ quanh trục z và được chỉ định bằng độ từ 0 đến 360. Các giá trị nằm ngoài phạm vi này sẽ được điều chỉnh để nằm trong phạm vi. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 530 cũng sẽ được chuyển đổi thành 170.
roll readonly	Loại: number Mặc định: 0 Xoay quanh trục y. Góc xoay dương là góc xoay theo chiều kim đồng hồ quanh trục y và được chỉ định bằng độ từ 0 đến 360. Các giá trị nằm ngoài phạm vi này sẽ được điều chỉnh để nằm trong phạm vi. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 530 cũng sẽ được chuyển đổi thành 170.
tilt readonly	Loại: number Mặc định: 0 Xoay quanh trục x. Góc xoay dương là góc xoay theo chiều kim đồng hồ quanh trục x và được chỉ định bằng độ từ 0 đến 360. Các giá trị nằm ngoài phạm vi này sẽ được điều chỉnh để nằm trong phạm vi. Ví dụ: giá trị -190 sẽ được chuyển đổi thành 170. Giá trị 530 cũng sẽ được chuyển đổi thành 170.

Phương thức
equals	equals(other) Tham số: other: Orientation3D|Orientation3DLiteral optional Một đối tượng Orientation3D khác. Giá trị trả về: boolean Cho biết hai đối tượng có bằng nhau hay không. Hàm so sánh.
toJSON	toJSON([key]) Tham số: key: string optional Giá trị trả về: Orientation3DLiteral Chuyển đổi thành một đối tượng thuần tuý.

Giao diện Orientation3DLiteral

google.maps.Orientation3DLiteral giao diện

Đối tượng chữ được chấp nhận thay cho đối tượng Orientation3D, để thuận tiện, ở nhiều nơi. Các đối tượng này được chuyển đổi thành đối tượng Orientation3D khi API Maps gặp chúng.

Thuộc tính
heading không bắt buộc	Loại: number optional Xoay quanh trục z (vuông góc với bề mặt Trái Đất). Giá trị 0 (mặc định) tương đương với hướng Bắc. Góc xoay dương là góc xoay theo chiều kim đồng hồ quanh trục z và được chỉ định bằng độ từ 0 đến 360.
roll không bắt buộc	Loại: number optional Xoay quanh trục y. Góc xoay dương là góc xoay theo chiều kim đồng hồ quanh trục y và được chỉ định bằng độ từ 0 đến 360.
tilt không bắt buộc	Loại: number optional Xoay quanh trục x. Góc xoay dương là góc xoay theo chiều kim đồng hồ quanh trục x và được chỉ định bằng độ từ 0 đến 360.

Lớp Vector3D

google.maps.Vector3D class
implements Vector3DLiteral
library "core"

Vector3D là một vectơ ba chiều dùng cho các phép toán chuẩn, chẳng hạn như điều chỉnh tỷ lệ ranh giới của đối tượng ba chiều dọc theo các trục x, y và z cục bộ.

• x là một số thực.
• y là số thực.
• z là một số thực.

const {Vector3D} = await google.maps.importLibrary("core");

Hàm dựng
Vector3D	Vector3D(value) Tham số: value: Vector3D|Vector3DLiteral Giá trị khởi tạo.

Thuộc tính
x readonly	Loại: number Thành phần X của vectơ ba chiều.
y readonly	Loại: number Thành phần Y của vectơ ba chiều.
z readonly	Loại: number Thành phần Z của vectơ ba chiều.

Phương thức
equals	equals(other) Tham số: other: Vector3D|Vector3DLiteral optional Một đối tượng Vector3D hoặc Vector3DLiteral khác. Giá trị trả về: boolean Hàm so sánh.
toJSON	toJSON([key]) Tham số: key: string optional Giá trị trả về: Vector3DLiteral Chuyển đổi thành một đối tượng thuần tuý.

Giao diện Vector3DLiteral

google.maps.Vector3DLiteral giao diện

Đối tượng chữ được chấp nhận thay cho đối tượng Vector3D, để thuận tiện, ở nhiều nơi. Các đối tượng này được chuyển đổi thành đối tượng Vector3D khi API Maps gặp chúng.

Thuộc tính
x	Loại: number Thành phần X của vectơ ba chiều.
y	Loại: number Thành phần Y của vectơ ba chiều.
z	Loại: number Thành phần Z của vectơ ba chiều.