Maps Service

Maps

Dịch vụ này cho phép tập lệnh tạo bản đồ tĩnh, tìm đường đi, chuyển đổi địa chỉ thành toạ độ mã hoá địa lý và lấy mẫu độ cao.

Lớp

Tên	Mô tả ngắn
Avoid	Một enum biểu thị các loại hạn chế cần tránh khi tìm đường.
Color	Một enum đại diện cho các màu có tên mà bạn có thể dùng trong hình ảnh bản đồ.
DirectionFinder	Cho phép truy xuất đường đi giữa các vị trí.
DirectionFinderEnums	Một tập hợp các giá trị enum mà DirectionFinder sử dụng.
ElevationSampler	Cho phép lấy mẫu độ cao tại các vị trí cụ thể.
Format	Một enum đại diện cho định dạng của hình ảnh bản đồ.
Geocoder	Cho phép chuyển đổi giữa địa chỉ và toạ độ địa lý.
Maps	Cho phép tìm đường, mã hoá địa lý, lấy mẫu độ cao và tạo hình ảnh bản đồ tĩnh.
MarkerSize	Một enum biểu thị kích thước của điểm đánh dấu được thêm vào bản đồ.
Mode	Một enum đại diện cho chế độ di chuyển sẽ dùng khi tìm đường.
StaticMap	Cho phép tạo và trang trí hình ảnh bản đồ tĩnh.
StaticMapEnums	Một tập hợp các giá trị enum mà StaticMap sử dụng.
Type	Một enum biểu thị loại bản đồ cần kết xuất.

Avoid

Thuộc tính

Thuộc tính	Loại	Mô tả
TOLLS	Enum	Tránh trạm thu phí.
HIGHWAYS	Enum	Tránh đường cao tốc.

Color

Thuộc tính

Thuộc tính	Loại	Mô tả
BLACK	Enum
BROWN	Enum
GREEN	Enum
PURPLE	Enum
YELLOW	Enum
BLUE	Enum
GRAY	Enum
ORANGE	Enum
RED	Enum
WHITE	Enum

DirectionFinder

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
addWaypoint(latitude, longitude)	DirectionFinder	Thêm một điểm tham chiếu mà tuyến đường phải đi qua, bằng cách sử dụng một điểm (lat/lng).
addWaypoint(address)	DirectionFinder	Thêm một điểm tham chiếu mà tuyến đường phải đi qua, bằng cách sử dụng địa chỉ.
clearWaypoints()	DirectionFinder	Xoá bộ điểm tham chiếu hiện tại.
getDirections()	Object	Lấy chỉ đường bằng cách sử dụng điểm bắt đầu, điểm đến và các lựa chọn khác đã được đặt.
setAlternatives(useAlternatives)	DirectionFinder	Đặt xem có nên trả về các tuyến đường thay thế hay không, thay vì chỉ trả về tuyến đường được xếp hạng cao nhất (mặc định là false).
setArrive(time)	DirectionFinder	Đặt thời gian đến dự kiến (nếu có).
setAvoid(avoid)	DirectionFinder	Đặt xem có tránh một số loại quy định hạn chế hay không.
setDepart(time)	DirectionFinder	Đặt thời gian khởi hành mong muốn (nếu có).
setDestination(latitude, longitude)	DirectionFinder	Đặt vị trí kết thúc để tính toán đường đi, bằng cách sử dụng một điểm (lat/lng).
setDestination(address)	DirectionFinder	Đặt vị trí kết thúc để tính toán đường đi, bằng cách sử dụng một địa chỉ.
setLanguage(language)	DirectionFinder	Đặt ngôn ngữ sẽ dùng cho chỉ đường.
setMode(mode)	DirectionFinder	Đặt chế độ di chuyển (mặc định là lái xe).
setOptimizeWaypoints(optimizeOrder)	DirectionFinder	Đặt xem có tối ưu hoá tuyến đường đã cung cấp bằng cách sắp xếp lại các điểm tham chiếu theo thứ tự hiệu quả hơn hay không (mặc định là false).
setOrigin(latitude, longitude)	DirectionFinder	Đặt vị trí bắt đầu để tính toán đường đi, bằng cách sử dụng một điểm (lat/lng).
setOrigin(address)	DirectionFinder	Đặt vị trí bắt đầu để tính toán đường đi bằng cách sử dụng địa chỉ.
setRegion(region)	DirectionFinder	Đặt một khu vực để sử dụng khi diễn giải tên vị trí.

DirectionFinderEnums

Thuộc tính

Thuộc tính	Loại	Mô tả
Avoid	Avoid
Mode	Mode

ElevationSampler

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
sampleLocation(latitude, longitude)	Object	Trả về dữ liệu độ cao cho một điểm duy nhất (vĩ độ/kinh độ).
sampleLocations(points)	Object	Trả về dữ liệu độ cao cho một chuỗi điểm (vĩ độ/kinh độ).
sampleLocations(encodedPolyline)	Object	Trả về dữ liệu độ cao cho các điểm trong một đường nhiều đường được mã hoá.
samplePath(points, numSamples)	Object	Trả về dữ liệu độ cao cho một số mẫu dọc theo một đường thẳng, được xác định bằng cách sử dụng một chuỗi điểm.
samplePath(encodedPolyline, numSamples)	Object	Trả về dữ liệu độ cao cho một số mẫu dọc theo một đường thẳng, được xác định bằng cách sử dụng một chuỗi đa tuyến được mã hoá.

Format

Thuộc tính

Thuộc tính	Loại	Mô tả
PNG	Enum	Định dạng PNG 8 bit.
PNG8	Enum	Định dạng PNG 8 bit.
PNG32	Enum	Định dạng PNG 32 bit.
GIF	Enum	Định dạng GIF.
JPG	Enum	Định dạng JPEG.
JPG_BASELINE	Enum	Định dạng JPEG không tăng tiến.

Geocoder

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
geocode(address)	Object	Lấy các điểm địa lý gần đúng cho một địa chỉ nhất định.
reverseGeocode(latitude, longitude)	Object	Lấy địa chỉ gần đúng cho một điểm địa lý nhất định.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)	Geocoder	Đặt ranh giới của một khu vực cần được ưu tiên hơn trong kết quả.
setLanguage(language)	Geocoder	Đặt ngôn ngữ sẽ được dùng trong kết quả.
setRegion(region)	Geocoder	Đặt một khu vực để sử dụng khi diễn giải tên vị trí.

Maps

Thuộc tính

Thuộc tính	Loại	Mô tả
DirectionFinder	DirectionFinderEnums
StaticMap	StaticMapEnums

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
decodePolyline(polyline)	Number[]	Giải mã một chuỗi đường nhiều đoạn đã mã hoá thành một mảng gồm các điểm.
encodePolyline(points)	String	Mã hoá một mảng các điểm thành một chuỗi.
newDirectionFinder()	DirectionFinder	Tạo một đối tượng DirectionFinder mới.
newElevationSampler()	ElevationSampler	Tạo một đối tượng ElevationSampler.
newGeocoder()	Geocoder	Tạo một đối tượng Geocoder mới.
newStaticMap()	StaticMap	Tạo một đối tượng StaticMap mới.
resetAuthenticationApiKey()	void	Đặt lại thông tin đăng nhập xác thực để sử dụng hạn mức mặc định.
setAuthenticationByApiKey(apiKey)	void	Cho phép sử dụng khoá API để xác thực các yêu cầu nhằm tận dụng hạn mức bổ sung.
setAuthenticationByApiKey(apiKey, signingKey)	void	Cho phép sử dụng Khoá API và Khoá ký để xác thực các yêu cầu nhằm tận dụng hạn mức bổ sung trong StaticMap.

MarkerSize

Thuộc tính

Thuộc tính	Loại	Mô tả
TINY	Enum	Thị trường có kích thước siêu nhỏ (nhỏ nhất có thể).
MID	Enum	Điểm đánh dấu cỡ trung (lớn nhất có thể).
SMALL	Enum	Điểm đánh dấu có kích thước nhỏ.

Mode

Thuộc tính

Thuộc tính	Loại	Mô tả
DRIVING	Enum	Thông tin chỉ đường lái xe qua các tuyến đường.
WALKING	Enum	Đường đi bộ qua lối đi bộ và vỉa hè (nếu có).
BICYCLING	Enum	Đường đi xe đạp qua đường dành cho xe đạp và đường phố ưu tiên (nếu có).
TRANSIT	Enum	Đường đi bằng phương tiện công cộng thông qua các tuyến đường của phương tiện công cộng (nếu có).

StaticMap

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
addAddress(address)	StaticMap	Thêm một địa chỉ mới vào định nghĩa đường dẫn hiện tại.
addMarker(latitude, longitude)	StaticMap	Thêm một điểm đánh dấu vào bản đồ bằng cách sử dụng một điểm (vĩ độ/kinh độ).
addMarker(address)	StaticMap	Thêm một điểm đánh dấu vào bản đồ bằng cách sử dụng địa chỉ.
addPath(points)	StaticMap	Thêm một đường dẫn vào bản đồ bằng cách sử dụng một mảng gồm nhiều điểm.
addPath(polyline)	StaticMap	Thêm một đường dẫn vào bản đồ bằng cách sử dụng một đường nhiều đoạn được mã hoá.
addPoint(latitude, longitude)	StaticMap	Thêm một điểm mới (lat/lng) vào định nghĩa đường dẫn hiện tại.
addVisible(latitude, longitude)	StaticMap	Thêm một vị trí điểm (lat/lng) phải xuất hiện trên bản đồ.
addVisible(address)	StaticMap	Thêm một vị trí địa chỉ phải xuất hiện trên bản đồ.
beginPath()	StaticMap	Bắt đầu một định nghĩa mới về đường dẫn.
clearMarkers()	StaticMap	Xoá nhóm điểm đánh dấu hiện tại.
clearPaths()	StaticMap	Xoá nhóm đường dẫn hiện tại.
clearVisibles()	StaticMap	Xoá nhóm vị trí hiện tại đang hiển thị.
endPath()	StaticMap	Hoàn tất một định nghĩa đường dẫn bắt đầu bằng beginPath().
getAs(contentType)	Blob	Trả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi sang loại nội dung đã chỉ định.
getBlob()	Blob	Lấy dữ liệu hình ảnh dưới dạng Blob.
getMapImage()	Byte[]	Lấy dữ liệu hình ảnh thô dưới dạng một mảng byte.
getMapUrl()	String	Lấy URL của hình ảnh bản đồ.
setCenter(latitude, longitude)	StaticMap	Đặt tâm của bản đồ bằng một điểm (vĩ độ/kinh độ).
setCenter(address)	StaticMap	Đặt tâm của bản đồ bằng một địa chỉ.
setCustomMarkerStyle(imageUrl, useShadow)	StaticMap	Đặt hình ảnh điểm đánh dấu tuỳ chỉnh để sử dụng khi tạo điểm đánh dấu mới.
setFormat(format)	StaticMap	Đặt định dạng cho hình ảnh bản đồ.
setLanguage(language)	StaticMap	Đặt ngôn ngữ sẽ dùng cho văn bản trên bản đồ (nếu có).
setMapType(mapType)	StaticMap	Đặt loại bản đồ sẽ xuất hiện.
setMarkerStyle(size, color, label)	StaticMap	Đặt kiểu dấu đánh dấu sẽ dùng khi tạo dấu đánh dấu mới.
setMobile(useMobileTiles)	StaticMap	Đặt xem có sử dụng các bộ ô chuyên biệt cho thiết bị di động hay không.
setPathStyle(weight, color, fillColor)	StaticMap	Đặt kiểu đường dẫn sẽ dùng khi tạo đường dẫn mới.
setSize(width, height)	StaticMap	Đặt chiều rộng và chiều cao của hình ảnh bản đồ theo pixel.
setZoom(zoom)	StaticMap	Đặt hệ số thu phóng hoặc mức phóng đại dùng cho bản đồ.

StaticMapEnums

Thuộc tính

Thuộc tính	Loại	Mô tả
Color	Color
Format	Format
MarkerSize	MarkerSize
Type	Type

Type

Thuộc tính

Thuộc tính	Loại	Mô tả
ROADMAP	Enum	Một lộ trình tiêu chuẩn, như thường thấy trên trang web Google Maps.
SATELLITE	Enum	Bản đồ vệ tinh.
TERRAIN	Enum	Bản đồ địa hình thực tế, cho thấy địa hình và thảm thực vật.
HYBRID	Enum	Bản đồ kết hợp giữa bản đồ vệ tinh và bản đồ đường bộ, cho thấy một lớp trong suốt gồm các đường phố chính và tên địa điểm trên bản đồ vệ tinh.