Gdy podążasz za podróżą, aplikacja dla konsumentów wyświetla lokalizację odpowiednim pojazdem. Żeby to zrobić, aplikacja musi się uruchomić śledzić podróż, aktualizować jej postępy i zatrzymywać śledzenie podróży, gdy .
Z tego dokumentu dowiesz się, jak to działa.
Zanim zaczniesz
Upewnij się, że masz skonfigurowane te elementy:
Usługi backendu dla aplikacji klienta są uruchomione, a usługi jest prowadzone w celu dopasowywania konsumentów do pojazdów.
Masz skonfigurowaną mapę dla swojej aplikacji.
Zacznij obserwować podróż
Gdy serwer backendu dopasuje konsumenta do pojazdu, użyj funkcji
JourneySharingSession
, aby zacząć śledzić podróż za pomocą udostępniania podróży.
Ten przykładowy kod pokazuje, jak rozpocząć udostępnianie ścieżek po widoku.
Java
public class MainActivity extends AppCompatActivity
implements ConsumerViewModel.JourneySharingListener {
// Class implementation
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// Create a TripModel instance to listen for updates to the trip specified by this trip name.
String tripName = ...;
TripModelManager tripModelManager = consumerApi.getTripModelManager();
TripModel tripModel = tripModelManager.getTripModel(tripName);
// Create a JourneySharingSession instance based on the TripModel.
JourneySharingSession session = JourneySharingSession.createInstance(tripModel);
// Add the JourneySharingSession instance on the map for updating the UI.
consumerController.showSession(session);
// Register for trip update events.
tripModel.registerTripCallback(new TripModelCallback() {
@Override
public void onTripETAToNextWaypointUpdated(
TripInfo tripInfo, @Nullable Long timestampMillis) {
// ...
}
@Override
public void onTripActiveRouteRemainingDistanceUpdated(
TripInfo tripInfo, @Nullable Integer distanceMeters) {
// ...
}
// ...
});
}
@Override
protected void onDestroy() {
super.onDestroy();
if (journeySharingSession != null) {
journeySharingSession.stop();
}
}
}
Kotlin
class SampleAppActivity : AppCompatActivity(), ConsumerViewModel.JourneySharingListener {
// Class implementation
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// Create a TripModel instance to listen for updates to the trip specified by this trip name.
val tripName = "tripName"
val tripModelManager = consumerApi.getTripModelManager()
val tripModel = tripModelManager.getTripModel(tripName)
// Create a JourneySharingSession instance based on the TripModel.
val session = JourneySharingSession.createInstance(tripModel)
// Add the JourneySharingSession instance on the map for updating the UI.
consumerController.showSession(session)
// Register for trip update events.
tripModel.registerTripCallback(
object : TripModelCallback() {
override fun onTripETAToNextWaypointUpdated(
tripInfo: TripInfo,
timestampMillis: Long?,
) {
// ...
}
override fun onTripActiveRouteRemainingDistanceUpdated(
tripInfo: TripInfo,
distanceMeters: Int?,
) {
// ...
}
// ...
})
}
override fun onDestroy() {
super.onDestroy()
journeySharingSession?.stop()
}
}
Zaktualizuj postęp podróży
Aby zaktualizować szczegóły postępu w podróży, np. odległość, jaką musi pokonać pojazd podróży przed przyjazdem i szacunkowej godziny przyjazdu, aplikacja musi: zarejestrować i skonfigurować odbiornik, jak pokazano w poniższych przykładach.
Zarejestruj detektor w obiekcie
TripModel
.Java
// Create a TripModel instance for listening to updates to the trip specified by this trip name. String tripName = ...; TripModelManager tripModelManager = consumerApi.getTripModelManager(); TripModel tripModel = tripModelManager.getTripModel(tripName); // Create a JourneySharingSession instance based on the TripModel. JourneySharingSession session = JourneySharingSession.createInstance(tripModel); // Add the JourneySharingSession instance on the map for updating the UI. consumerController.showSession(session); // Register for trip update events. tripModel.registerTripCallback(new TripModelCallback() { @Override public void onTripETAToNextWaypointUpdated( TripInfo tripInfo, @Nullable Long timestampMillis) { // ... } @Override public void onTripActiveRouteRemainingDistanceUpdated( TripInfo tripInfo, @Nullable Integer distanceMeters) { // ... } // ... });
Kotlin
// Create a TripModel instance for listening to updates to the trip specified by this trip name. val tripName = "tripName" val tripModelManager = consumerApi.getTripModelManager() val tripModel = tripModelManager.getTripModel(tripName) // Create a JourneySharingSession instance based on the TripModel. val session = JourneySharingSession.createInstance(tripModel) // Add the JourneySharingSession instance on the map for updating the UI. consumerController.showSession(session) // Register for trip update events. tripModel.registerTripCallback( object : TripModelCallback() { override fun onTripETAToNextWaypointUpdated( tripInfo: TripInfo, timestampMillis: Long?, ) { // ... } override fun onTripActiveRouteRemainingDistanceUpdated( tripInfo: TripInfo, distanceMeters: Int?, ) { // ... } // ... })
Skonfiguruj detektor w podróży, używając usługi
TripModelOptions
.Java
// Set refresh interval to 2 seconds. TripModelOptions tripOptions = TripModelOptions.builder().setRefreshIntervalMillis(2000).build(); tripModel.setTripModelOptions(tripOptions);
Kotlin
// Set refresh interval to 2 seconds. val tripOptions = TripModelOptions.builder().setRefreshIntervalMillis(2000).build() tripModel.setTripModelOptions(tripOptions)
Przestań obserwować podróż
Upewnij się, że aplikacja przestanie śledzić podróż, gdy nie jest już potrzebna, na przykład tak, jak gdy kierowca zaznaczy na backendzie podróż jako ZAKOŃCZONO. Zatrzymuję podróż udostępnianie pozwala uniknąć zbędnych żądań sieciowych do Fleet Engine i uniemożliwia pamięć wyciek danych.
Użyj aplikacji JourneySharingSession
, aby zatrzymać śledzenie podróży zgodnie z instrukcjami na
ten przykładowy kod.
Java
public class MainActivity extends AppCompatActivity
implements ConsumerViewModel.JourneySharingListener {
// Class implementation
@Override
protected void onDestroy() {
super.onDestroy();
if (journeySharingSession != null) {
journeySharingSession.stop();
}
}
}
Kotlin
class SampleAppActivity : AppCompatActivity(), ConsumerViewModel.JourneySharingListener {
// Class implementation
override fun onDestroy() {
super.onDestroy()
journeySharingSession?.stop()
}
}
Obsługa błędów związanych z podróżą
Metoda onTripRefreshError
wyświetla błędy, które występują podczas podróży
i monitorowania. Komunikaty o błędach są zgodne ze standardem błędów Google Cloud. Szczegółowe informacje
definicje komunikatów o błędach i wszystkie kody błędów znajdziesz na stronie Błędy Google Cloud
dokumentacji.
Oto kilka częstych błędów, które mogą wystąpić podczas monitorowania podróży:
HTTP | RPC | Opis |
---|---|---|
400 | NIEPRAWIDŁOWY_ARG | Klient podał nieprawidłową nazwę podróży. Nazwa podróży musi być zgodna z
format: providers/{provider_id}/trips/{trip_id} .
provider_id musi być identyfikatorem projektu Cloud należącego do
z dostawcą usług. |
401 | BEZ UWIERZYTELNIANIA | Ten błąd występuje, jeśli nie istnieją prawidłowe dane uwierzytelniające. Jeśli na przykład token JWT jest podpisany bez identyfikatora podróży lub tokena JWT wygasła. |
403 | PERMISSION_DENIED | Ten błąd pojawia się, jeśli klient nie ma wystarczających uprawnień (na przykład użytkownik z rolą konsumenta próbuje wywołać funkcję updateTrip), jeśli token JWT jest nieprawidłowy lub interfejs API nie jest włączony w projekcie klienta. Być może brakuje tokena JWT lub jest on podpisany za pomocą identyfikatora podróży, nie pasuje do żądanego identyfikatora podróży. |
429 | RESOURCE_EXHAUSTED | Limit zasobów wynosi zero lub tempo ruchu przekracza limit. |
503 | PRODUKT NIEDOSTĘPNY | Usługa niedostępna Zwykle serwer nie działa. |
504 | DEADLINE_EXCEEDED | Przekroczono termin prośby. Ten błąd występuje tylko wtedy, gdy wywołujący termin, który jest krótszy niż domyślny termin metody (czyli żądany termin nie wystarcza do przetworzenia żądania przez serwer) oraz prośba nie została zrealizowana w terminie. |
Obsługa błędów pakietów SDK dla konsumentów
Pakiet SDK Consumer SDK wysyła do aplikacji konsumenta błędy aktualizacji podróży za pomocą wywołania zwrotnego
. Parametr wywołania zwrotnego jest typem zwrotu specyficznym dla platformy (
TripUpdateError
na Androidzie oraz
NSError
w systemie iOS).
Wyodrębnianie kodów stanu
Błędy przekazywane do wywołania zwrotnego są zwykle błędami gRPC. Możesz również wyodrębnienia z nich dodatkowych informacji w postaci kodu stanu. W przypadku atrybutu pełna lista kodów stanu, patrz Kody stanu i ich zastosowania w gRPC.
Java
Możesz wyodrębnić kod stanu gRPC zawierający szczegółowe informacje o błędzie
od: TripUpdateError
zwróconych przez: onTripUpdateError()
.
// Called when there is a trip update error.
@Override
public void onTripUpdateError(TripInfo tripInfo, TripUpdateError error) {
Status.Code code = error.getStatusCode();
}
Kotlin
Możesz wyodrębnić kod stanu gRPC zawierający szczegółowe informacje o błędzie
od: TripUpdateError
zwróconych przez: onTripUpdateError()
.
// Called when there is a trip update error.
override fun onTripUpdateError(tripInfo: TripInfo, error: TripUpdateError) {
val code = error.getStatusCode()
}
Zinterpretuj kody stanu
Kody stanu obejmują dwa rodzaje błędów: błędy serwera i sieci oraz po stronie klienta.
Błędy serwera i sieci
Poniższe kody stanu dotyczą błędów sieci lub serwera i nie muszą nic robić. Pakiet SDK klienta automatycznie po takim okresie.
Kod stanu | Opis |
---|---|
ANULOWANO | Serwer przestał wysyłać odpowiedź. Przyczyną tej sytuacji jest zwykle problem z serwerem. |
ANULOWANO | Serwer zakończył odpowiedź wychodzącą. To normalne.
ma miejsce, gdy
aplikacja jest wysyłana w tle lub po zmianie stanu Aplikacja dla klientów indywidualnych. |
PRZERW | |
DEADLINE_EXCEEDED | Oczekiwanie na odpowiedź serwera trwało zbyt długo. |
PRODUKT NIEDOSTĘPNY | Serwer był niedostępny. Przyczyną problemu jest zwykle sieć . |
Błędy klienta
Poniższe kody stanu dotyczą błędów klienta i musisz podjąć działania, aby i ją rozwiązać. Pakiet SDK klienta będzie ponawiać próby odświeżenia podróży, dopóki nie aby zakończyć udostępnianie ścieżki, ale nie zostanie ono przywrócone, dopóki nie podejmiesz działań.
Kod stanu | Opis |
---|---|
NIEPRAWIDŁOWY_ARG | Aplikacja konsumenta podała nieprawidłową nazwę podróży. Nazwa podróży musi
musi mieć format providers/{provider_id}/trips/{trip_id} .
|
NOT_FOUND | Podróż nie została utworzona. |
PERMISSION_DENIED | Aplikacja konsumenta ma niewystarczające uprawnienia. Ten błąd występuje, gdy:
|
RESOURCE_EXHAUSTED | Limit zasobów wynosi zero lub tempo przepływu ruchu przekracza ograniczenia prędkości. |
BEZ UWIERZYTELNIANIA | Uwierzytelnianie nie powiodło się z powodu nieprawidłowego tokena JWT. Ten występuje, gdy token JWT jest podpisany bez identyfikatora podróży lub po wygaśnięciu tokena JWT. |