حزمة React Native

توفر حزمة @navvo/react-native-maps الرسمية أمرين:

• <NavvoMapView/> — مكوّن خريطة Navvo تفاعلي قابل للتضمين (الكاميرا، الدبابيس، تبديل الأنماط، أغلفة GeoJSON) يشير إلى GET /tiles/style لدى Navvo.
• NavvoServices — عميل كامل الأنواع (TypeScript) لخدمة Navvo (البحث، الترميز الجغرافي، الأماكن، التوجيه، حركة المرور، المصفوفات، مناطق الوصول، الطقس، الشحن الكهربائي، النقل العام…).

كل شيء بهوية Navvo ولا يستدعي سوى https://navvo.io/api/v1. الإحداثيات موحّدة بشكل { lat, lng }.

التثبيت

npm install @navvo/react-native-maps

التهيئة

import { NavvoMaps } from '@navvo/react-native-maps';

NavvoMaps.initialize({ apiKey: 'nvvo_YOUR_KEY' });

عرض خريطة

<NavvoMapView
  styleName="standard"
  camera={{ center: { lat: 31.9539, lng: 35.9106 }, zoom: 12 }}
>
  <NavvoMarker id="a" position={{ lat: 31.9539, lng: 35.9106 }} />
</NavvoMapView>

استخدام الخدمات (بدون خريطة)

import { NavvoServices } from '@navvo/react-native-maps';

const svc = NavvoServices.instance;
const result = await svc.search('قهوة في عبدون', { near: { lat: 31.95, lng: 35.91 }, limit: 8 });

الأخطاء

أصناف أخطاء كاملة الأنواع: ‏NavvoAuthError (401)، NavvoScopeError (403)، NavvoNotFoundError (404)، NavvoValidationError (400/422)، NavvoRateLimitError (429)، NavvoServerError (5xx)، NavvoNetworkError/NavvoAbortError.