base on A Mapbox react native module for creating custom maps # Mapbox Maps SDK for React Native <table style="border: none; border-width: 0px"> <tr style="border: none; border-width: 0px"> <td style="border: none; border-width: 0px"> <img src="./assets/mapbox_logo.png" height="75"> </td> <td style="border: none; border-width: 0px"> <img src="./assets/React-icon.svg" height="75"> </td> </tr> </table> | [![npm version](https://badge.fury.io/js/%40rnmapbox%2Fmaps.svg)](https://badge.fury.io/js/%40rnmapbox%2Fmaps) | [![iOS & Android Build](https://github.com/rnmapbox/maps/actions/workflows/on-push.yml/badge.svg?branch=main)](https://github.com/rnmapbox/maps/actions/workflows/on-push.yml?branch=main) | |---|---| _A community-supported, open-source React Native library for building maps with the [Mapbox Maps SDK for iOS](https://www.mapbox.com/ios-sdk/) and [Mapbox Maps SDK for Android](https://www.mapbox.com/android-sdk/)_ --- ## News & Discussions #### <span style="color:red">&rarr;</span> Call for additional maintainers [discussion thread](https://github.com/rnmapbox/maps/discussions/1551) --- <table> <tr> <td colspan="2" align="center"> <img src="./assets/intro-examples.png"/> </td> </tr> <tr> <td> <img src="./assets/beta-maps-example-point-annotation-960-d280759f6a3d8d75458f399c7a044926.webp" width="1200"/> </td> </tr> <tr> <td> <img src="./assets/beta-maps-guides-migrate-3d-terrain-960-48b1080117817ccfd92e434d0df7546f.webp" width="1200"/> </td> </tr> <tr> <td> <img src="./assets/maps-examples-building-extrusions-960-aaa140cce77da4e8b2dd216032b191b6.webp" width="1200"/> </td> </tr> <tr> <td> <img src="./assets/maps-examples-data-driven-symbols-960-2e2061a6b8127ef305c1b6c159f8dc65.webp" width="1200"/> </td> </tr> </table> --- ### Supported Implementations At the moment we support Mapbox (v10) and Mapbox (v11) beta. We default to Mapbox (v10). _See [iOS](ios/install.md) & [Android](android/install.md) setup guide for using v11 beta_ ## Prerequisite 1. Please [Sign Up to Mapbox](https://account.mapbox.com/auth/signup/) to get the Mapbox Access Token. ## Dependencies - [node](https://nodejs.org) - [npm](https://www.npmjs.com/) - [React Native](https://facebook.github.io/react-native/) (0.70+, older versions from 0.64+ might or might not work) ## Installation Check our [Installation instructions](https://rnmapbox.github.io/docs/install) ### Getting Started For more information, check out our [Getting Started](/docs/GettingStarted.md) section ## Run Project Before you run your project be sure you have completed the Installation Guides for Android or iOS. ### Run iOS Simulator ```sh # Run with yarn yarn run ios # or Run with NPM npm run ios ``` ### Run Android Emulator ```sh # Run with yarn yarn run android # or Run with NPM npm run android ``` ## Adding a map ```js import React from 'react'; import { StyleSheet, View } from 'react-native'; import Mapbox from '@rnmapbox/maps'; Mapbox.setAccessToken('<YOUR_ACCESSTOKEN>'); const App = () => { return ( <View style={styles.page}> <View style={styles.container}> <Mapbox.MapView style={styles.map} /> </View> </View> ); } export default App; const styles = StyleSheet.create({ page: { flex: 1, justifyContent: 'center', alignItems: 'center', }, container: { height: 300, width: 300, }, map: { flex: 1 } }); ``` --- ## Documentation ### Components - [MapView](/docs/MapView.md) - [StyleImport](/docs/StyleImport.md) - [Light](/docs/Light.md) - [StyleSheet](/docs/StyleSheet.md) - [PointAnnotation](/docs/PointAnnotation.md) - [MarkerView](/docs/MarkerView.md) - [Callout](/docs/Callout.md) - [Camera](docs/Camera.md) - [UserLocation](docs/UserLocation.md) - [LocationPuck](docs/LocationPuck.md) - [Images](docs/Images.md) - [Image](docs/Image.md) - [Models](docs/Models.md) ### Sources - [VectorSource](/docs/VectorSource.md) - [ShapeSource](/docs/ShapeSource.md) - [RasterSource](/docs/RasterSource.md) - [RasterDemSource](/docs/RasterDemSource.md) ### Layers - [BackgroundLayer](/docs/BackgroundLayer.md) - [CircleLayer](/docs/CircleLayer.md) - [FillExtrusionLayer](/docs/FillExtrusionLayer.md) - [FillLayer](/docs/FillLayer.md) - [LineLayer](/docs/LineLayer.md) - [RasterLayer](/docs/RasterLayer.md) - [SymbolLayer](/docs/SymbolLayer.md) - [HeatmapLayer](/docs/HeatmapLayer.md) - [SkyLayer](/docs/SkyLayer.md) - [ModelLayer](/docs/ModelLayer.md) ### Terrain - [Terrain](/docs/Terrain.md) - [Atmosphere](/docs/Atmosphere.md) ### Offline - [OfflineManager](/docs/OfflineManager.md) - [SnapshotManager](/docs/snapshotManager.md) ### Misc - [Mapbox](/docs/Mapbox.md) - [CustomHttpHeaders](/docs/CustomHttpHeaders.md) - [Logger](/docs/Logger.md) ## Expo Support This package is not available in the [Expo Go](https://expo.io/client) app. Learn how you can use it with [custom dev clients](/plugin/install.md). ## Testing with Jest This library provides some mocks which are necessary for running tests. Example: ```json "jest": { "preset": "react-native", "setupFilesAfterEnv": ["@rnmapbox/maps/setup-jest"], "transformIgnorePatterns": [ "node_modules/(?!(...|@rnmapbox))" ] } ``` --- ## Sponsors Help drive this repo forward - be a sponsor. Add a comment [here](https://github.com/rnmapbox/maps/discussions/1551) to discuss your sponsorship. <table style="border: none; border-width: 0px"> <tr> <td align="center"> <a href="https://scouttohunt.com/" target="_blank"> <img src="./assets/sponsors/sth.png" alt="Scout To Hunt" height="60" /> </td> <td align="center"> <a href="https://terrain.dance/" target="_blank"> <img src="./assets/sponsors/terrain.dance.png" alt="Terrain Dance LLC" height="60" /> </a> </td> </tr> <tr> <td align="center"></a> <a href="https://scouttohunt.com/" target="_blank">Scout To Hunt</a></td> <td align="center"><a href="https://terrain.dance/" target="_blank">Terrain Dance</a></td> </tr> </table> --- ## Developer Group Have a question or need some help? Use [Github discussions](https://github.com/rnmapbox/maps/discussions) or the [react-native channel](https://discord.com/channels/1004826913229000704/1092426983696248893) in the mapbox discord. ", Assign "at most 3 tags" to the expected json: {"id":"13485","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"