Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

翻译location.md #12

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open

翻译location.md #12

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
cdb4d23
翻译location.md
lordmos Sep 24, 2017
b2be0ad
location.md校订，tutorial章节的ng-chapter-0.md初翻
lordmos Sep 26, 2017
f9924b8
对ng-chapter-0.md进行自我校订
lordmos Sep 26, 2017
f66de90
修改部分用词和修正错误
lordmos Sep 26, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
91 changes: 89 additions & 2 deletions docs/hardware/location.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,42 +8,78 @@ previous_url: /location

# Location

# 地理位置

> **IMPORTANT:** Starting with NativeScript 1.5.0, the built-in Location module is deprecated. To implement geolocation in your apps, use the `nativescript-geolocation` plugin, available via npm. This plugin provides an API similar to the [W3C Geolocation API](http://dev.w3.org/geo/api/spec-source.html).

> **重要信息:** 内建的地理位置模块将从NativeScript 1.5.0版本开始被弃用。若要在应用中实现地理位置处理功能, 可用npm安装`nativescript-geolocation`插件。该插件提供了与[W3C Geolocation API](http://dev.w3.org/geo/api/spec-source.html)相仿的API。

The most important difference between the deprecated module and the new plugin is that location monitoring via the plugin returns an `id` that you can use to stop location monitoring. The `nativescript-geolocation` plugin also uses an accuracy criteria approach to deliver geolocation. This means that getting a location is powered by the most accurate location provider that is available. For example, if a GPS signal is available and the GPS provider is enabled, the plugin uses GPS; if GPS is not connected, the device falls back to other available providers such as Wi-Fi networks or cell towers).

被弃用的模块和新启用的插件之间最大的区别在于，通过插件获取到的位置监控器返回一个`id`，这个`id`可以用来停止位置监控器。此外，`nativescript-geolocation`插件还通过使用一种高精度标准的方式来提供地理位置信息。这意味着获取的位置信息由当前可用的最精确的位置提供者提供。例如，如果可以获取到GPS信号而且GPS提供者被启用，则插件使用GPS；如果GPS无法连接，则设备使用其他可用的提供者，例如Wi-Fi网络或者蜂窝网络信号塔。

This approach does not limit location monitoring only to a specific location provider; it can still work with all of them.

但这种方式并不会把位置监控器限定为某个特定的位置提供者，而是仍使用全部的。

You might want to start with this [example](https://github.com/nsndeck/locationtest), which demonstrates how to use the `nativescript-geolocation` plugin.

你可能会希望通过一个[示例](https://github.com/nsndeck/locationtest)来学会如何使用`nativescript-geolocation`插件。

To make the plugin available in your app, run the following command:

为了在你的App中使用这个插件，请执行以下的命令：

```Shell
tns plugin add nativescript-geolocation
```

```Shell
tns plugin add nativescript-geolocation
```

To import the module in your code, use:

之后在代码中引入插件：

{% nativescript %}
```JavaScript
var geolocation = require("nativescript-geolocation");
```

{% endnativescript %}
```TypeScript
import { isEnabled, enableLocationRequest, getCurrentLocation, watchLocation, distance, clearWatch } from "nativescript-geolocation";
```

## Getting information about a location service

## 获取和位置服务相关的信息

NativeScript has a universal way to check if location services are turned on—the `isEnabled` method. The method returns a Boolean value (true if the location service is enabled).

在NativeScript中使用了`isEnabled`这个通用方法来检查位置服务是否开启。方法会返回一个`Boolean`类型的值(如果位置服务已开启则返回`true`)。

> **NOTE:** For Android, `isEnabled` checks if the location service is enabled (any accuracy level). For iOS, the method checks if the location service is enabled for the application in foreground or background mode.

> **注意:** 在Android平台下，`isEnabled`检测的是（任意精度等级）的位置服务是否启用。而在iOS中，这个方法检查的是应用在前台或者后台等任意状态下位置服务是否启用。

## Requesting permissions to use location services

## 获取使用位置服务的权限

By default, the `nativescript-geolocation` plugin adds the required permissions in `AndroidManiest.xml` for Android and `Info.plist` for iOS. For iOS, the plugin adds two dummy string values which serve as the message when the platform asks for permission to use location services. You can edit this message later.

`nativescript-geolocation`会默认在Android平台下的`AndroidManiest.xml`和iOS平台下的`Info.plist`中添加所需的权限。此外，在iOS平台下，插件添加了两个空字符串作为提示语句，它们将会在平台向用户请求位置服务权限时使用。你可以在之后修改它。

After you install the plugin, you can request to use location services in the app with the code in __Example 1__:

在完成插件的安装后，你可以使用__样例1__中的代码来请求使用位置服务。

> Example 1: How to enable location service on a device

> 样例1：如何在设备中启用位置服务

{% nativescript %}
```XML
<Page>
Expand Down Expand Up @@ -78,8 +114,12 @@ exports.enableLocationTap = enableLocationTap;

## Getting location

## 获取定位

You can get location with `getCurrentLocation` or with `watchLocation`. Using `distance`, you can obtain the distance between two locations.

你可以通过`getCurrentLocation`或`watchLocation`方法来获取位置信息，并通过`distance`方法来获取两个位置之间的距离。

* [getCurrentLocation](#getcurrentlocation)
* [watchLocation](#watchlocation)
* [distance](#distance)
Expand All @@ -88,12 +128,20 @@ You can get location with `getCurrentLocation` or with `watchLocation`. Using `d

This method gets a single location. It accepts the `location options` parameter.

此方法用来获取单个位置信息，它接受`location options`参数。

`getCurrentLocation` returns a `Promise<Location>` where `Location` and `location options` are defined as follows.

`getCurrentLocation`方法返回`Promise<Location>`。对`Location`和`location options`的定义如下。

#### Class: location
#### 类: location
A data class that encapsulates common properties for a geolocation.

一个包含地理位置基本信息的数据类。

##### Instance properties
##### 实例属性

Property | Type | Description
---|---|---
Expand All @@ -108,10 +156,28 @@ Property | Type | Description
`android` | Object | The Android-specific [location](http://developer.android.com/reference/android/location/Location.html) object.
`ios` | CLLocation | The iOS-specific [CLLocation](https://developer.apple.com/library/ios/documentation/CoreLocation/Reference/CLLocation_Class/) object.


属性 | 类型 | 描述
---|---|---
`latitude` | Number | 纬度，以度数（deg）为单位。
`longitude` | Number | 经度，以度数（deg）为单位。
`altitude` | Number | 海拔（如果可用），以米为单位。
`horizontalAccuracy` | Number | 水平精度，以米为单位。
`verticalAccuracy` | Number | 垂直精度，以米为单位。
`speed` | Number | 速度，以米每秒为单位。
`direction` | Number | 方向（航向），以度数（deg）为单位。
`timestamp` | Object | 刚刚取到此位置时的时间戳。
`android` | Object | Android特有[位置](http://developer.android.com/reference/android/location/Location.html)对象。
`ios` | CLLocation | iOS特有[位置](https://developer.apple.com/library/ios/documentation/CoreLocation/Reference/CLLocation_Class/)对象。

#### Interface: options
#### 接口: options
Provides options for location monitoring.

为位置检测提供的选项。

##### Properties
##### 属性

Property | Type | Description
---|---|---
Expand All @@ -121,7 +187,18 @@ Property | Type | Description
`maximumAge` | Number | (Optional) Filters locations by how long ago they were received, in milliseconds. For example, if the `maximumAge` is 5000, you will get locations only from the last 5 seconds.
`timeout` | Number | (Optional) Specifies how long to wait for a location, in milliseconds.

属性 | 类型 | 描述
---|---|---
`desiredAccuracy` | Number | (可选的)指定所需的精度，以米为单位。NativeScript有一个特殊的枚举类型[Accuracy](http://docs.nativescript.org/api-reference/modules/_ui_enums_.accuracy.html)来帮助提高代码的可读性。默认设为`Accuracy.any`。这样的精度可以通过WiFi和辅助GPS来实现，不会对电池消耗造成额外的压力。若要使用高精度模式（需要GPS传感器）请将其设置为`Accuracy.high`。
`updateDistance` | Number | (可选的) 更新距离筛选器，以米为单位。指定更新的频率。在iOS中无法筛选，在Android中默认为0米。
`minimumUpdateTime` | Number | (可选的) 设置位置信息更新的最小间隔时间，以毫秒为单位。在iOS中会被忽略。
`maximumAge` | Number | (可选的) 筛选多少时间内我们获取到的位置信息，以毫秒为单位。例如，如果`maximumAge`设置为5000，你只会获取到5秒内获取到的位置数据。
`timeout` | Number | (可选的) 设置获取位置的最大等待时间，以毫秒为单位。

> Example 2: How to get current location

> 样例2：如何获取当前位置

{% nativescript %}
```XML
<Page>
Expand Down Expand Up @@ -168,7 +245,11 @@ exports.buttonGetLocationTap = buttonGetLocationTap;

With this method, location watching does not stop automatically until the `clearWatch` method is called. You might need to use this method in apps which require a GPS log or active location tracking.

> Example 3: How to handle location chnage event
使用此方法会让位置监视一直生效，直到你调用了`clearWatch`方法才会停止。在App中可能需要通过它来实现GPS日志获取或者实时位置跟踪。

> Example 3: How to handle location change event

> 样例3：如何处理位置发生变化的事件

{% nativescript %}
```XML
Expand Down Expand Up @@ -235,7 +316,11 @@ exports.buttonStopTap = buttonStopTap;

This method lets you measure the distance between two locations in meters.

> Example 4: How to get distance between to too location
此方法用来计算两个位置之间距离，以米为单位。

> Example 4: How to get distance between to two location

> 样例4：获取两个位置之间的距离

{% nativescript %}
```JavaScript
Expand All @@ -252,6 +337,8 @@ function getDistance(loc1, loc2) {

## See Also

## 其他参考

* [NativeScript Plugins](http://docs.nativescript.org/plugins/plugins)
* [Location Module (Deprecated)](http://docs.nativescript.org/api-reference/modules/_location_.html)
* [NativeScript-Geolocation in NPM](https://www.npmjs.com/package/nativescript-geolocation)
50 changes: 50 additions & 0 deletions docs/tutorial/ng-chapter-0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,53 +8,103 @@ environment: angular

# Building Apps with NativeScript and Angular

# 使用NativeScript和Angular来构建应用

Welcome to the NativeScript & Angular getting started guide. In this hands-on tutorial, you’ll build a cross-platform iOS and Android app from scratch.

欢迎来到NativeScript与Angular快速上手教程。在本次实战中，你将会从头开始构建一个横跨iOS与Android平台的App。

## Table of contents

## 目录

- [0.1: What is NativeScript? What is Angular?](#01-what-is-nativescript-what-is-angular)
- [0.1: 什么是NativeScript?什么是Angular?](#01-what-is-nativescript-what-is-angular)
- [0.2: Prerequisites](#02-prerequisites)
- [0.2: 预备知识](#02-prerequisites)
- [0.3: Installation](#03-installation)
- [0.3: 安装](#03-installation)

> **TIP**: If you’re a video learner, the third-party site NativeScripting has a [free video course](https://nativescripting.com/course/nativescript-with-angular-getting-started-guide) that walks you through this guide step by step.

> **提示**: 如果你喜欢用视频的方式进行学习，在第三方网站NativeScripting中有一个[免费的视频课程](https://nativescripting.com/course/nativescript-with-angular-getting-started-guide)，它会一步一步带你完成本教程。

## 0.1: What is NativeScript? What is Angular?

## 0.1: 什么是NativeScript? 什么是Angular?

<div class="intro-box">
<img src="../img/cli-getting-started/angular/chapter0/NativeScript_logo.png" class="plain" alt="NativeScript logo">
<p><a href="https://www.nativescript.org/">NativeScript</a> is a free and open source framework for building native iOS and Android apps using JavaScript and CSS. NativeScript renders UIs with the native platform’s rendering engine—no <a href="http://developer.telerik.com/featured/what-is-a-webview/">WebViews</a>—resulting in native-like performance and UX.</p>
</div>

<div class="intro-box">
<img src="../img/cli-getting-started/angular/chapter0/NativeScript_logo.png" class="plain" alt="NativeScript logo">
<p><a href="https://www.nativescript.org/">NativeScript</a>是一个免费、开源的框架，它通过使用JavaScript和CSS来构建原生的iOS以及Android应用。NativeScript使用原生平台的渲染引擎—而不是<a href="http://developer.telerik.com/featured/what-is-a-webview/">WebViews</a>—来渲染用户界面，从而得到接近原生的性能和用户体验。</p>
</div>

<div class="intro-box">
<img src="../img/cli-getting-started/angular/chapter0/Angular_logo.png" class="plain" alt="Angular logo">
<p><a href="https://angular.io/">Angular</a> is one of the most popular open source JavaScript frameworks for application development. The latest version of Angular makes it possible to use the framework outside of a web browser, and developers at <a href="https://www.progress.com/">Progress</a>—the company that created and maintains NativeScript—<a href="http://angularjs.blogspot.com/2015/12/building-mobile-apps-with-angular-2-and.html">worked closely with developers at Google for over a year</a> to make Angular in NativeScript a reality.</p>
</div>

<div class="intro-box">
<img src="../img/cli-getting-started/angular/chapter0/Angular_logo.png" class="plain" alt="Angular logo">
<p><a href="https://angular.io/">Angular</a>是最流行的JavaScript应用开发开源框架之一。最新版本的Angular可以脱离浏览器使用。在经过<a href="https://www.progress.com/">Progress</a>—创建和维护NativeScript的公司—<a href="http://angularjs.blogspot.com/2015/12/building-mobile-apps-with-angular-2-and.html">的开发者与Google的开发者一年多的紧密合作，</a>使得在NativeScript中使用Angular成为现实。</p>
</div>

The result is a software architecture that allows you to build mobile apps using the same framework—and in some cases the same code—that you use to build Angular web apps, with the performance you’d expect from native code. Let’s look at how it all works by building an app.

因此，我们可以用相同的框架——甚至是相同代码——来同时构建Angular Web应用和移动应用，并且得到你所期望的原生代码的性能。现在我们来了解如何用它来构建应用。

> **NOTE**: If you spot any issues while completing this guide, let us know on our [Angular GitHub repo](https://github.com/NativeScript/nativescript-angular/issues).

> **注意**: 如果在完成教程的过程中遇到什么问题，请提交issue到[Angular GitHub repo](https://github.com/NativeScript/nativescript-angular/issues)让我们知道。

## 0.2: Prerequisites

## 0.2: 预备知识

This guide assumes that you have some basic knowledge of JavaScript, CSS, and your development machine’s terminal. More specifically:

本教程会假设你已经拥有了一些JavaScript、CSS和终端的基础知识。详细的有:

* **JavaScript**: You should know basic JavaScript concepts, such as how functions, if statements, and loops work.
* **JavaScript**: 了解JavaScript的基础概念，例如如何使用函数，if语句和循环。
* **CSS**: You should know how to write simple CSS selectors, and know how to apply CSS rules as name/value pairs.
* **CSS**: 知道如何写一些简单的CSS选择器, 同时也知道如何使用CSS规则例如键值对。
* **The terminal**: You should know how to open a terminal or command-line prompt on your development machine, how to change directories, and how to execute commands.
* **终端**: 需要知道如何在你的开发设备上打开终端或者命令行工具，如何切换路径以及如何执行命令。
* **A text editor or IDE**: You should know the basics of your text editor or IDE of choice. You can use any text editor to build NativeScript apps, however, for the best possible experience you may want an editor with built-in TypeScript support, such as [Visual Studio Code](https://code.visualstudio.com/).
* **一个文本编辑器或者集成开发环境**: 对你所选的文本编辑器或者集成开发环境有基本的了解。你可以使用任何一个文本编辑器来构建NativeScript应用，但是通过经验来看你最好选择一个内建TypeScript支持的编辑器例如[Visual Studio Code](https://code.visualstudio.com/)。

This guide will _not_ assume you have any knowledge of Angular or TypeScript. When background Angular or TypeScript expertise will help you understand a concept, this guide will link you to the appropriate places in the [Angular](https://angular.io/docs/ts/latest/) or [TypeScript](http://www.typescriptlang.org/Handbook) documentation.

本教程_并不_假设你有任何关于Angular或者TypeScript的知识。当需要Angular或TypeScript的专业知识作为背景帮你了解一些概念的时候，教程将会给出一个适当的[Angular](https://angular.io/docs/ts/latest/)或[TypeScript](http://www.typescriptlang.org/Handbook)文档链接供你参考。

## 0.3: Installation

## 0.3: 安装

In order to start this tutorial you need to have the NativeScript CLI (command-line interface) installed on your development machine, which you can do using the link below.

在开始教程前需要将NativeScript CLI(命令行界面)安装到你的开发设备上。可以参照下面链接中的内容完成安装。

* [Complete the NativeScript installation guide](/start/quick-setup)
* [带你完成NativeScript的安装](/start/quick-setup)

> **TIP**: Setting up your machine for native development can be tricky, especially if you’re new to mobile development. If you get stuck, or if you have questions while going through these instructions, the [NativeScript community forum](http://forum.nativescript.org/) is a great place to get help.

> **提示**: 配置原生开发环境的过程中可能会有奇怪的问题，特别是对移动开发陌生的情况下。如果你遇到困难，或者在学习过程中碰到一些问题，[NativeScript community forum](http://forum.nativescript.org/)将会是个获取帮助的好去处。

With that out of the way, let’s get started building apps with NativeScript!

搞定以上这些，就让我们开始用NativeScript构建应用吧!

<div class="next-chapter-link-container">
<a href="ng-chapter-1">Continue to Chapter 1—Getting Up and Running</a>
</div>

<div class="next-chapter-link-container">
<a href="ng-chapter-1">继续第一章—开始和运行</a>
</div>