{ "_args": [ [ { "raw": "react-native-maps@0.19.0", "scope": null, "escapedName": "react-native-maps", "name": "react-native-maps", "rawSpec": "0.19.0", "spec": "0.19.0", "type": "version" }, "/home/jdaugherty/work/GT2/GT2-Android/node_modules/expo" ] ], "_from": "react-native-maps@0.19.0", "_id": "react-native-maps@0.19.0", "_inCache": true, "_location": "/react-native-maps", "_nodeVersion": "8.2.1", "_npmOperationalInternal": { "host": "s3://npm-registry-packages", "tmp": "tmp/react-native-maps-0.19.0.tgz_1513290881107_0.9988682505208999" }, "_npmUser": { "name": "cdro", "email": "casheghian@gmail.com" }, "_npmVersion": "5.3.0", "_phantomChildren": {}, "_requested": { "raw": "react-native-maps@0.19.0", "scope": null, "escapedName": "react-native-maps", "name": "react-native-maps", "rawSpec": "0.19.0", "spec": "0.19.0", "type": "version" }, "_requiredBy": [ "/expo" ], "_resolved": "https://registry.npmjs.org/react-native-maps/-/react-native-maps-0.19.0.tgz", "_shasum": "ce94fad1cf360e335cb4338a68c95f791e869074", "_shrinkwrap": null, "_spec": "react-native-maps@0.19.0", "_where": "/home/jdaugherty/work/GT2/GT2-Android/node_modules/expo", "author": { "name": "Leland Richardson", "email": "leland.m.richardson@gmail.com" }, "bugs": { "url": "https://github.com/airbnb/react-native-maps/issues" }, "dependencies": {}, "description": "React Native Mapview component for iOS + Android", "devDependencies": { "babel-eslint": "^6.1.2", "babel-plugin-module-resolver": "^2.3.0", "babel-preset-airbnb": "^1.1.1", "babel-preset-react-native": "1.9.0", "eslint": "^3.3.1", "eslint-config-airbnb": "^10.0.1", "eslint-plugin-import": "^1.14.0", "eslint-plugin-jsx-a11y": "^2.1.0", "eslint-plugin-prefer-object-spread": "^1.1.0", "eslint-plugin-react": "^6.1.2", "gitbook-cli": "^2.3.0", "lodash": "^4.17.2", "prop-types": "^15.5.10", "react": "16.0.0", "react-native": "0.51.0" }, "directories": {}, "dist": { "integrity": "sha512-1THgPVHh8/NL/kLIyPWIsfTpjncT94O92xW+NOt+VQrdMMLX2mynyKnD/we02H29urAtYBXO8ZmVTrZ4ITn8mg==", "shasum": "ce94fad1cf360e335cb4338a68c95f791e869074", "tarball": "https://registry.npmjs.org/react-native-maps/-/react-native-maps-0.19.0.tgz" }, "gitHead": "c45131096fda44383335099bee80c2cd2136c231", "homepage": "https://github.com/airbnb/react-native-maps#readme", "keywords": [ "react", "react-native", "react-component", "map", "mapview", "google-maps", "mapkit" ], "main": "index.js", "maintainers": [ { "name": "ljharb", "email": "ljharb@gmail.com" }, { "name": "gpeal", "email": "gabriel@gpeal.com" }, { "name": "felipecsl", "email": "felipe.lima@gmail.com" }, { "name": "airbnb", "email": "jordan.harband+npm@airbnb.com" }, { "name": "spikebrehm", "email": "ocelot@gmail.com" }, { "name": "gilbox", "email": "g@gilbox.me" }, { "name": "jrichardlai", "email": "jrichardlai@gmail.com" }, { "name": "cdro", "email": "casheghian@gmail.com" }, { "name": "intelligibabble", "email": "leland.m.richardson@gmail.com" } ], "name": "react-native-maps", "optionalDependencies": {}, "peerDependencies": { "react": "16.0.0", "react-native": "0.51.0", "prop-types": "^15.5.10" }, "readme": "# react-native-maps [![npm version](https://img.shields.io/npm/v/react-native-maps.svg?style=flat)](https://www.npmjs.com/package/react-native-maps)\n\nReact Native Map components for iOS + Android\n\n## Installation\n\nSee [Installation Instructions](docs/installation.md).\n\nSee [Setup Instructions for the Included Example Project](docs/examples-setup.md).\n\n## Compatibility\n\nDue to the rapid changes being made in the React Native ecosystem, we are not officially going to\nsupport this module on anything but the latest version of React Native. With that said, we will do\nour best to stay compatible with older versions as much that is practical, and the peer dependency\nof this requirement is set to `\"react-native\": \"*\"` explicitly for this reason. If you are using\nan older version of React Native with this module though, some features may be buggy.\n\n### Note about React requires\n\nSince react-native 0.25.0, `React` should be required from `node_modules`.\nReact Native versions from 0.18 should be working out of the box, for lower\nversions you should add `react` as a dependency in your `package.json`.\n\n## Component API\n\n[`` Component API](docs/mapview.md)\n\n[`` Component API](docs/marker.md)\n\n[`` Component API](docs/callout.md)\n\n[`` Component API](docs/polygon.md)\n\n[`` Component API](docs/polyline.md)\n\n[`` Component API](docs/circle.md)\n\n## General Usage\n\n```js\nimport MapView from 'react-native-maps';\n```\nor\n\n```js\nvar MapView = require('react-native-maps');\n```\n\nThis MapView component is built so that features on the map (such as Markers, Polygons, etc.) are\nspecified as children of the MapView itself. This provides an intuitive and react-like API for\ndeclaratively controlling features on the map.\n\n### Rendering a Map with an initial region\n\n## MapView\n```jsx\n \n```\n\n### Using a MapView while controlling the region as state\n\n```jsx\ngetInitialState() {\n return {\n region: {\n latitude: 37.78825,\n longitude: -122.4324,\n latitudeDelta: 0.0922,\n longitudeDelta: 0.0421,\n },\n };\n}\n\nonRegionChange(region) {\n this.setState({ region });\n}\n\nrender() {\n return (\n \n );\n}\n```\n\n### Rendering a list of markers on a map\n\n```jsx\n\n {this.state.markers.map(marker => (\n \n ))}\n\n```\n\n### Rendering a Marker with a custom view\n\n```jsx\n\n \n\n```\n\n### Rendering a Marker with a custom image\n\n```jsx\n\n```\n\n### Rendering a custom Marker with a custom Callout\n\n```jsx\n\n \n \n \n \n\n```\n\n### Draggable Markers\n\n```jsx\n\n this.setState({ x: e.nativeEvent.coordinate })}\n />\n\n```\n\n### Using a custom Tile Overlay\n\n#### Tile Overlay using tile server\n\n```jsx\n\n \n\n```\n\nFor Android: add the following line in your AndroidManifest.xml\n```xml\n\n```\nFor IOS: configure [App Transport Security](https://developer.apple.com/library/content/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW33) in your app\n\n#### Tile Overlay using local tiles\n\nTiles can be stored locally within device using xyz tiling scheme and displayed as tile overlay as well. This is usefull especially for offline map usage when tiles are available for selected map region within device storage.\n\n```jsx\n\n \n\n```\n\nFor Android: LocalTile is still just overlay over original map tiles. It means that if device is online, underlying tiles will be still downloaded. If original tiles download/display is not desirable set mapType to 'none'. For example:\n```\n\n```\n\nSee [OSM Wiki](https://wiki.openstreetmap.org/wiki/Category:Tile_downloading) for how to download tiles for offline usage.\n\n### Customizing the map style\n\nCreate the json object, or download a generated one from the [google style generator](https://mapstyle.withgoogle.com/).\n\n```jsx\n// The generated json object\nmapStyle = [ ... ]\n\nrender() {\n return (\n \n );\n}\n```\nFor iOS, in addition to providing the `mapStyle` you will need to do the following\n\n```jsx\nimport MapView, { PROVIDER_GOOGLE } from 'react-native-maps'\n\n// ...\n\n\n```\n\nThen add the AirGoogleMaps directory:\n\nhttps://github.com/airbnb/react-native-maps/blob/1e71a21f39e7b88554852951f773c731c94680c9/docs/installation.md#ios\n\nAn unofficial step-by-step guide is also available at https://gist.github.com/heron2014/e60fa003e9b117ce80d56bb1d5bfe9e0\n\n## Examples\n\n### MapView Events\n\nThe `` component and its child components have several events that you can subscribe to.\nThis example displays some of them in a log as a demonstration.\n\n![](http://i.giphy.com/3o6UBpncYQASu2WTW8.gif) ![](http://i.giphy.com/xT77YdviLqtjaecRYA.gif)\n\n\n\n### Tracking Region / Location\n\n![](http://i.giphy.com/3o6UBoPSLlIKQ2dv7q.gif) ![](http://i.giphy.com/xT77XWjqECvdgjx9oA.gif)\n\n\n\n\n### Programmatically Changing Region\n\nOne can change the mapview's position using refs and component methods, or by passing in an updated\n`region` prop. The component methods will allow one to animate to a given position like the native\nAPI could.\n\n![](http://i.giphy.com/3o6UB7poyB6YJ0KPWU.gif) ![](http://i.giphy.com/xT77Yc4wK3pzZusEbm.gif)\n\n\n### Changing the style of the map\n\n![](http://i.imgur.com/a9WqCL6.png)\n\n\n\n### Arbitrary React Views as Markers\n\n![](http://i.giphy.com/3o6UBcsCLoLQtksJxe.gif) ![](http://i.giphy.com/3o6UB1qGEM9jYni3KM.gif)\n\n\n\n### Using the MapView with the Animated API\n\nThe `` component can be made to work with the Animated API, having the entire `region` prop\nbe declared as an animated value. This allows one to animate the zoom and position of the MapView along\nwith other gestures, giving a nice feel.\n\nFurther, Marker views can use the animated API to enhance the effect.\n\n![](http://i.giphy.com/xT77XMw9IwS6QAv0nC.gif) ![](http://i.giphy.com/3o6UBdGQdM1GmVoIdq.gif)\n\nIssue: Since android needs to render its marker views as a bitmap, the animations APIs may not be\ncompatible with the Marker views. Not sure if this can be worked around yet or not.\n\nMarkers' coordinates can also be animated, as shown in this example:\n\n![](http://i.giphy.com/xTcnTelp1OwGPu1Wh2.gif) ![](http://i.giphy.com/xTcnT6WVpwlCiQnFW8.gif)\n\n\n\n### Polygon Creator\n\n![](http://i.giphy.com/3o6UAZWqQBkOzs8HE4.gif) ![](http://i.giphy.com/xT77XVBRErNZl3zyWQ.gif)\n\n\n\n### Other Overlays\n\nSo far, ``, ``, and `` are available to pass in as children to the\n`` component.\n\n![](http://i.giphy.com/xT77XZCH8JpEhzVcNG.gif) ![](http://i.giphy.com/xT77XZyA0aYeOX5jsA.gif)\n\n\n\n### Default Markers\n\nDefault markers will be rendered unless a custom marker is specified. One can optionally adjust the\ncolor of the default marker by using the `pinColor` prop.\n\n![](http://i.giphy.com/xT77Y0pWKmUUnguHK0.gif) ![](http://i.giphy.com/3o6UBfk3I58VIwZjVe.gif)\n\n\n\n### Custom Callouts\n\nCallouts to markers can be completely arbitrary react views, similar to markers. As a result, they\ncan be interacted with like any other view.\n\nAdditionally, you can fall back to the standard behavior of just having a title/description through\nthe ``'s `title` and `description` props.\n\nCustom callout views can be the entire tooltip bubble, or just the content inside of the system\ndefault bubble.\n\n![](http://i.giphy.com/xT77XNePGnMIIDpbnq.gif) ![](http://i.giphy.com/xT77YdU0HXryvoRqaQ.gif)\n\n\n\n### Image-based Markers\n\nMarkers can be customized by just using images, and specified using the `image` prop.\n\n![](http://i.imgur.com/mzrOjTR.png)\n\n\n\n### Draggable Markers\n\nMarkers are draggable, and emit continuous drag events to update other UI during drags.\n\n![](http://i.giphy.com/l2JImnZxdv1WbpQfC.gif) ![](http://i.giphy.com/l2JIhv4Jx6Ugx1EGI.gif)\n\n### Lite Mode ( Android )\n\nEnable lite mode on Android with `liteMode` prop. Ideal when having multiple maps in a View or ScrollView.\n\n![](http://i.giphy.com/qZ2lAf18s89na.gif)\n\n### Animated Region\n\nThe MapView can accept an `MapView.AnimatedRegion` value as its `region` prop. This allows you to utilize the Animated API to control the map's center and zoom.\n\n```jsx\nimport MapView from 'react-native-maps';\n\ngetInitialState() {\n return {\n region: new MapView.AnimatedRegion({\n latitude: LATITUDE,\n longitude: LONGITUDE,\n latitudeDelta: LATITUDE_DELTA,\n longitudeDelta: LONGITUDE_DELTA,\n }),\n };\n}\n\nonRegionChange(region) {\n this.state.region.setValue(region);\n}\n\nrender() {\n return (\n \n );\n}\n```\n\n### Animated Marker Position\n\nMarkers can also accept an `AnimatedRegion` value as a coordinate.\n\n```jsx\ngetInitialState() {\n return {\n coordinate: new MapView.AnimatedRegion({\n latitude: LATITUDE,\n longitude: LONGITUDE,\n }),\n };\n}\n\ncomponentWillReceiveProps(nextProps) {\n if (this.props.coordinate !== nextProps.coordinate) {\n this.state.coordinate.timing({\n ...nextProps.coordinate,\n duration: 500\n }).start();\n }\n}\n\nrender() {\n return (\n \n \n \n );\n}\n```\n\n### Take Snapshot of map\n\n```jsx\ngetInitialState() {\n return {\n coordinate: {\n latitude: LATITUDE,\n longitude: LONGITUDE,\n },\n };\n}\n\ntakeSnapshot () {\n // 'takeSnapshot' takes a config object with the\n // following options\n const snapshot = this.map.takeSnapshot({\n width: 300, // optional, when omitted the view-width is used\n height: 300, // optional, when omitted the view-height is used\n region: {..}, // iOS only, optional region to render\n format: 'png', // image formats: 'png', 'jpg' (default: 'png')\n quality: 0.8, // image quality: 0..1 (only relevant for jpg, default: 1)\n result: 'file' // result types: 'file', 'base64' (default: 'file')\n });\n snapshot.then((uri) => {\n this.setState({ mapSnapshot: uri });\n });\n}\n\nrender() {\n return (\n \n { this.map = map }}>\n \n \n \n \n Take Snapshot\n \n \n );\n}\n```\n\n### Zoom to Specified Markers\n\nPass an array of marker identifiers to have the map re-focus.\n\n![](http://i.giphy.com/3o7qEbOQnO0yoXqKJ2.gif) ![](http://i.giphy.com/l41YdrQZ7m6Dz4h0c.gif)\n\n### Zoom to Specified Coordinates\n\nPass an array of coordinates to focus a map region on said coordinates.\n\n![](https://cloud.githubusercontent.com/assets/1627824/18609960/da5d9e06-7cdc-11e6-811e-34e255093df9.gif)\n\n### Troubleshooting\n\n#### My map is blank\n\n* Make sure that you have [properly installed](docs/installation.md) react-native-maps.\n* Check in the logs if there is more informations about the issue.\n* Try setting the style of the MapView to an absolute position with top, left, right and bottom values set.\n* Make sure you have enabled Google Maps API in ![Google developer console](https://console.developers.google.com/apis/library)\n\n```javascript\nconst styles = StyleSheet.create({\n map: {\n ...StyleSheet.absoluteFillObject,\n },\n});\n```\n\n```jsx\n\n```\n\n#### Inputs don't focus\n\n* When inputs don't focus or elements don't respond to tap, look at the order of the view hierarchy, sometimes the issue could be due to ordering of rendered components, prefer putting MapView as the first component.\n\nBad:\n\n```jsx\n\n \n \n\n```\n\nGood:\n\n```jsx\n\n \n \n\n```\n\n\nLicense\n--------\n\n Copyright (c) 2017 Airbnb\n\n Licensed under the The MIT License (MIT) (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n https://raw.githubusercontent.com/airbnb/react-native-maps/master/LICENSE\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License.\n", "readmeFilename": "README.md", "repository": { "type": "git", "url": "git+https://github.com/airbnb/react-native-maps.git" }, "rnpm": { "android": { "sourceDir": "./lib/android" } }, "scripts": { "build": "npm run build:js && npm run build:android && npm run build:ios", "build:android": "./gradlew :react-native-maps:assembleDebug", "build:ios": "bundle install --binstubs ./examples/ios && bundle exec pod install --project-directory=./example/ios/", "build:js": "exit 0", "ci": "npm run lint", "lint": "eslint ./", "preversion": "./scripts/update-version.js", "run:android": "./gradlew installDebug && npm run start:android", "run:ios": "react-native run-ios --project-path ./example/ios", "run:packager": "./node_modules/react-native/packager/packager.sh", "start": "node node_modules/react-native/local-cli/cli.js start", "start:android": "adb shell am start -n com.airbnb.android.react.maps.example/.MainActivity" }, "version": "0.19.0" }