เอกสาร / การตั้งค่า / React / Mappls
การตั้งค่า Mappls
ขั้นตอนการใช้ Web SDK ของ Mappls (MapmyIndia) จาก MapConductor ในเว็บจะส่งคีย์ API ไปยัง view state
PACKAGE
@mapconductor/react-for-mappls
API KEY
จำเป็น
VIEW
MapplsMapView2D
TIME
10 นาที
ก่อนเริ่ม
โปรเจกต์ที่มี Node.js และ React 18 ขึ้นไป
บัญชี Mappls (MapmyIndia) และคีย์ API
STEP 01
รับคีย์ API
ออกคีย์ API สำหรับเว็บในคอนโซลนักพัฒนา Mappls ต่างจากเนทีฟ เว็บทำงานด้วยคีย์เดียวไม่ใช่ไฟล์การตั้งค่า
STEP 02
ติดตั้งแพ็กเกจ
SDK เว็บของ Mappls ถูกรวมเป็น dependency
shellShell
npm install @mapconductor/react-for-mappls @mapconductor/js-sdk-core @mapconductor/js-sdk-react
STEP 03
ส่งคีย์ไปยัง view state
ส่งคีย์ไปยัง useMapplsViewState อย่าใส่ค่าจริงในการจัดการซอร์สโค้ด แต่โหลดผ่านกลไกตัวแปรสภาพแวดล้อมของเครื่องมือบิวด์ที่ใช้
ตรวจสอบ
สิ่งที่ควรเห็น
แสดงแผนที่ที่มีศูนย์กลางที่เดลี เมื่อไทล์โหลดเสร็จแล้วก็เสร็จสิ้น
import {
MapplsDesign,
MapplsMapView2D,
useMapplsViewState,
} from '@mapconductor/react-for-mappls';
import { createGeoPoint, createMapCameraPosition } from '@mapconductor/js-sdk-core';
// Your own key. Read it from your environment however your build tool does
// it, and keep it out of source control.
const MAPPLS_API_KEY = '…';
const DELHI = createGeoPoint({ latitude: 28.6139, longitude: 77.2090 });
export default function App() {
const state = useMapplsViewState({
apiKey: MAPPLS_API_KEY,
mapDesignType: MapplsDesign.Default,
cameraPosition: createMapCameraPosition({ position: DELHI, zoom: 11 }),
});
return (
<div style={{ width: '100vw', height: '100vh' }}>
<MapplsMapView2D state={state} />
</div>
);
}ดีไซน์แผนที่
Notes
Default
สไตล์เริ่มต้นที่ใช้งานได้โดยไม่ขึ้นกับสัญญา
StandardDay
สไตล์กลางวันมาตรฐาน
StandardNight / GreyDay
ตัวเลือกแบบชำระเงินที่มีค่าใช้จ่ายเพิ่มเติม หากไม่มีสัญญา SDK จะปฏิเสธ
การแก้ปัญหา
แผนที่ขาวสะอาด ไม่มีไทล์มาเลย
- ตรวจสอบว่าตั้งค่าข้อมูลรับรองก่อนการสร้างแผนที่หรือไม่
- ตรวจสอบในคอนโซล Mappls ว่าคีย์มีผลและไม่เกินโควต้าการใช้งานหรือไม่
- ตรวจสอบว่าอุปกรณ์สามารถเชื่อมต่อเครือข่ายได้หรือไม่
เมื่อเปลี่ยนสไตล์แล้วเกิด style not found
- StandardNight และ GreyDay เป็นตัวเลือกแบบชำระเงินที่มีค่าใช้จ่ายเพิ่มเติม หากไม่มีสัญญาให้ใช้ Default หรือ StandardDay
ไม่สามารถโหลดสคริปต์ SDK ได้เนื่องจาก 401
- SDK เว็บของ Mappls ถูกโหลดจาก sdk.mappls.com ด้วยคีย์ หากได้รับ 401 แสดงว่าคีย์นั้นไม่มีสิทธิ์ใช้ SDK เว็บหรือหมดอายุ
ถัดไป
marker, polyline, polygon, circle, groundImage, rasterLayer และ InfoBubble ยังสามารถใช้ผ่าน API ทั่วไปได้