# Api Plugin

Source: https://maps.vietmap.vn/docs/vi/sdk-mobile/react-native/react-plugin/

Package JavaScript/TypeScript để gọi các [API VIETMAP](https://maps.vietmap.vn/docs/vi/map-api/overview/).

# Vietmap API plugin

!!! warning "Plugin đang gọi API bản cũ"
    `@vietmap/vietmap-api` 1.1.2 gọi Autocomplete v3, Search v3, Place v3, Reverse v3 và endpoint Route, TSP bản cũ (`api-version`). Tích hợp mới cần địa chỉ sau sáp nhập, phí cầu đường hay chỉ đường cho xe tải thì gọi thẳng các [API v4](https://maps.vietmap.vn/docs/vi/map-api/overview/) qua HTTP.

## Cài đặt

Dùng npm:

```bash
npm install --save @vietmap/vietmap-api
```

Dùng Yarn:

```bash
yarn add @vietmap/vietmap-api
```

Dùng pnpm:

```bash
pnpm add @vietmap/vietmap-api
```

Phiên bản mới nhất xem tại [https://www.npmjs.com/package/@vietmap/vietmap-api](https://www.npmjs.com/package/@vietmap/vietmap-api)
<br>
## Cách dùng

### Import VietmapApi

```typescript
import { VietmapApi } from '@vietmap/vietmap-api';
```

Tạo instance bằng API key:

```typescript
const VietmapApi = new VietmapApi({ apiKey: VIETMAP_API_KEY })
```

## Ví dụ

### Reverse
Đổi toạ độ (vĩ độ, kinh độ) thành địa chỉ gần nhất.

```typescript
const reverseResponse = await vietmapApi.reverse({
  latitude: 35.72379,
  longitude: 51.33417,
});
```

### Autocomplete
Gợi ý địa chỉ, địa điểm ngay khi người dùng gõ.




```typescript
const autoCompleteSearchResponseList = await vietmapApi.autoCompleteSearch(
  new SearchRequest({ text: 'Vietmap' }),
);
```

### Search - Geocode
Tìm địa chỉ đầy đủ và trả về danh sách kết quả khớp.
```typescript

const searchResponseList = await vietmapApi.search(
  new SearchRequest({ text: 'Vietmap' }),
);
```
### Routing
Tìm đường giữa hai điểm trở lên theo loại phương tiện, trả về tổng quãng đường, thời gian dự kiến và hướng dẫn từng chặng.

```typescript
    const res = await vietmapApi.route(
      [[10.79628438955497,106.70592293472612], [10.801891047584164,106.70660958023404]],
      new RouteRequest({ vehicle: 'car',apikey: envVariables.VIETMAP_API_KEY,points_encoded: true, optimize:true}),
    ) 
```

### Giải mã polyline
API chỉ đường trả về đường đi dưới dạng chuỗi polyline đã mã hoá.
Dùng hàm giải mã polyline để đổi chuỗi đó thành danh sách `LatLng`.
```typescript
  const polyline = new Polyline()
  const listLatLng = polyline.decode('c_hjS}s{`A{C}`@',5)
```

</br>
</br>

[<img src="https://bizweb.dktcdn.net/100/415/690/themes/804206/assets/logo.png?1689561872933" height="40"/> </p>](https://maps.vietmap.vn)
Email: [maps.info@vietmap.vn](mailto:maps.info@vietmap.vn)



Liên hệ [hỗ trợ](https://maps.vietmap.vn/web#contact-section)

Tài liệu API VIETMAP: [Tổng quan Map API](https://maps.vietmap.vn/docs/vi/map-api/overview/)

Gặp lỗi? [Tạo issue](https://github.com/vietmap-company/vietmap_api_js_plugin/issues) trên GitHub, kèm log đầy đủ và thông tin để tái hiện lỗi nếu có thể.
Cần thêm tính năng? [Tạo issue](https://github.com/vietmap-company/vietmap_api_js_plugin/issues) mô tả tính năng đó làm gì và vì sao bạn cần.