Building an app that uses Google
Services generally follows this pattern.
First, you'll create a Google API
client, and on that client
you'll specify the services that
you want to use the desired API.
In this case, it's location services.
Now, the activity that hosts this
client will need to be extended for
the appropriate callbacks and listeners.
The first of these is
GoogleApiClientConnectionCallbacks.
These allow you to code against
events in the Api Client itself,
such as connecting, or
disconnecting from the services.
The next is the
GoogleApiClient.OnConnectionFailedListe-
ner.
This can alert you when
the connection drops,
so that you can handle failures to
connect to Google Apis Gracefully.
Specifically for location services,
you'll also need the location listener.
And as its name suggests,
it listens to location updates so
that you can respond to
them in your application.
You then connect your clients and
wait for the on connected call back.
Now for this app, you're going to
have code that makes a request for
your current location.
You put that in
the OnConnected Callback, and
this sets up another Callback
called OnLocationChanged.
And when the OnLocationChange Callback
fires, it will contain your location
information so that you can capture
details such as the latitude, and
update your UI accordingly.
لتكوين تطبيق مستخدماً Google نلتزم التالي.
أولاً، ستقوم بإنشاء عميل واجهة برمجة تطبيق
Google، وفي الواجهة
ستقوم بتخيصيص الخدمات التي تريدها لاستخدام
واجهة برمجة تطبيقك المفضل.
في هذه الحالة، تكون خدمات الموقع.
حاليًا، هذا النشاط الذي يستضيف العميل
سيكون في حاجة إلى التوسيع
للاستدعاءات المناسبة والمراقبات.
أول هذه الأشياء استدعاءات اتصال عميل
واجهة برمجة تطبيق Google.
وتمكنك من التحكم في الأحداث في
واجهة برمجة التطبيق ذاتها،
مثل الاتصال، أو قطع الاتصال من الخدمات.
التالي هو
موزع فشل اتصال عميل واجهة برمجة تطبيق
Google.
ويقوم بتنبيهك عند فشل الاتصال،
حتى تقوم بمعالجة المشاكل للاتصال
بواجهات برمجة التطبيق بسلاسة.
بالتحديد في خدمات الموقع، ستكون أيضاً
في حاجة إلى موزع الموقع.
وكما يشير اسمه فهو مسؤول عن توزيع
تحديثات الموقع لكي
تقوم بتحديثهم في تطبيقك.
تقوم بعد ذلك بربط واجهات برمجة التطبيق
لديك وتنتظر استدعاءات الاتصال.
الآن في هذا التطبيق، سيكون لديك تعليمة
برمجية تقوم بطلب
موقعك الحالي.
تقوم بوضع ذلك في إعادة استدعاء الاتصال
ويقوم ذلك بإعداد إعادة استدعاء آخرى تُسمى
تغيير الموقع.
وعند ارسال إعادة استدعاء تغيير الموقع، سيتضمن
معلومات عن موقعك حتى تقوم بتسجيل بعض
التفاصيل مثل خط العرض
وتحديث واجهة برمجة التطبيق.
Criar um aplicativo
que usa Google Services
geralmente segue esse padrão.
Primeiro, você criará
um cliente Google API,
e nesse cliente você especificará
os serviços que você quer
que use a API desejada.
Neste caso, Location Services.
Agora, a atividade que hospeda esse cliente
precisará ser ampliada
para os callbacks e ouvintes
apropriados.
O primeiro deles é
GoogleApiClientConnectionCallbacks.
Eles permitem que você codifique
eventos no próprio cliente API,
como conectar
ou desconectar serviços.
O próximo é
GoogleApiClient.OnConnectionFailedListener.
Ele pode alertá-lo quando
a conexão cai,
para que você possa lidar com falhas
na conexão com Google Apis corretamente.
Especificamente para Location Services,
você também precisará
do Location Listener.
E como o nome sugere,
ele ouve as atualizações de localização
para que você possa respondê-las
em seu aplicativo.
Então você conecta seus clientes,
e aguarda
o callback de OnConnected.
Para esse aplicativo, você terá
código que faz uma solicitação
para sua localização atual.
Você coloca isso
no callback OnConnected,
e isso define outro Callback
chamado OnLocationChanged.
E quando o callback OnLocationChange
dispara, ele contém suas informações
de localização para que você capture
detalhes como latitude
e atualize sua IU adequadamente.
构建使用 Google 服务的应用一般遵循这样一种模式
首先 创建一个 Google API 客户端
在该客户端上指定想在所需的 API 上使用的服务
在本例中就是定位服务
现在 承载此客户端的 activity 将需要
针对适当的回调和侦听器进行扩展
这些回调和侦听器中的第一个是 GoogleApiClientConnectionCallbacks
它们允许针对 API 客户端中的事件自己进行编码
如连接到服务或从服务断开
下一个是
使用 GoogleApiClient.OnConnectionFailedListener 扩展 activity
它可以在连接中断时提醒你 以便处理故障
从而很好地连接到 Google API
具体对于定位服务 还需要位置侦听器
正如其名称所暗示 它侦听位置更新
以便在应用程序中进行回应
然后连接客户端并等待 OnConnected 回调
现在 对于此应用程序 你将得到代码
该代码可要求提供你的当前位置
将其放入 OnConnected 回调中
该回调可设置另一个称为 OnLocationChanged 的回调
当 OnLocationChange 回调发出时 它将包含你的位置信息
以便捕捉诸如经度之类的详情
并相应地更新 UI