DocumentazioneMobile SDKGuida di Places Service

Utilizzo del proprio monitor using-your-monitor

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Puoi anche utilizzare i servizi di monitoraggio e integrarli con Places Service utilizzando le API dell’estensione Places.

Registrazione dei recinti geografici

Se decidi di utilizzare i servizi di monitoraggio, registra i recinti geografici dei POI intorno alla posizione corrente completando i passaggi seguenti:

iOS

In iOS, completa i seguenti passaggi:

  1. Passa all’estensione Places gli aggiornamenti sulla posizione ottenuti dai servizi di posizione core di iOS.

  2. Utilizzare l'API dell'estensione Luoghi getNearbyPointsOfInterest per ottenere la matrice di ACPPlacesPoi oggetti intorno alla posizione corrente.

    code language-objective-c 
    - (void) locationManager: (CLLocationManager*) manager didUpdateLocations: (NSArray<CLLocation*>*) locations {
    [ACPPlaces getNearbyPointsOfInterest:currentLocation limit:10 callback: ^ (NSArray<ACPPlacesPoi*>* _Nullable nearbyPoi) {
        [self startMonitoringGeoFences:nearbyPoi];
    }];
}

  3. Estrai le informazioni dagli oggetti ACPPlacesPOI ottenuti e avvia il monitoraggio di tali POI.

    code language-objective-c 
    - (void) startMonitoringGeoFences: (NSArray*) newGeoFences {
    // verify if the device supports monitoring geofences
    // check for location permission

    for (ACPPlacesPoi * currentRegion in newGeoFences) {
        // make the circular region
        CLLocationCoordinate2D center = CLLocationCoordinate2DMake(currentRegion.latitude, currentRegion.longitude);
        CLCircularRegion* currentCLRegion = [[CLCircularRegion alloc] initWithCenter:center
                                                                              radius:currentRegion.radius
                                                                          identifier:currentRegion.identifier];
        currentCLRegion.notifyOnExit = YES;
        currentCLRegion.notifyOnEntry = YES;

        // start monitoring the new region
        [_locationManager startMonitoringForRegion:currentCLRegion];
    }
}

Android

  1. Passa all’estensione Places gli aggiornamenti sulla posizione ottenuti dai servizi Google Play o dai servizi di posizione di Android.

  2. Utilizzare l'API dell'estensione Places getNearbyPointsOfInterest per ottenere l'elenco di PlacesPoi oggetti intorno alla posizione corrente.

    code language-java 
    LocationCallback callback = new LocationCallback() {
    @Override
    public void onLocationResult(LocationResult locationResult) {
        super.onLocationResult(locationResult);

        Places.getNearbyPointsOfInterest(currentLocation, 10, new AdobeCallback<List<PlacesPOI>>() {
            @Override
            public void call(List<PlacesPOI> pois) {
                starMonitoringGeofence(pois);
            }
        });
    }
};

  3. Estrai i dati dagli oggetti PlacesPOI ottenuti e avvia il monitoraggio di tali POI.

    code language-java 
    private void startMonitoringFences(final List<PlacesPOI> nearByPOIs) {
    // check for location permission
    for (PlacesPOI poi : nearByPOIs) {
        final Geofence fence = new Geofence.Builder()
            .setRequestId(poi.getIdentifier())
            .setCircularRegion(poi.getLatitude(), poi.getLongitude(), poi.getRadius())
            .setExpirationDuration(Geofence.NEVER_EXPIRE)
            .setTransitionTypes(Geofence.GEOFENCE_TRANSITION_ENTER |
                                Geofence.GEOFENCE_TRANSITION_EXIT)
            .build();
        geofences.add(fence);
    }

    GeofencingRequest.Builder builder = new GeofencingRequest.Builder();
    builder.setInitialTrigger(GeofencingRequest.INITIAL_TRIGGER_ENTER);
    builder.addGeofences(geofences);
    builder.build();
    geofencingClient.addGeofences(builder.build(), geoFencePendingIntent)
}

La chiamata all'API getNearbyPointsOfInterest genera una chiamata di rete che ottiene la posizione intorno alla posizione corrente.

IMPORTANT
È necessario chiamare l’API con moderazione o solo quando si verifica un cambiamento significativo della posizione dell’utente.

Registrazione di eventi recinto geografico

iOS

In iOS, chiama l'API processGeofenceEvent Places nel delegato CLLocationManager. Questa API indica se l’utente ha iniziato o chiuso l’accesso a un’area specifica.

- (void) locationManager:(CLLocationManager *)manager didEnterRegion:(CLRegion *)region {
    [ACPPlaces processRegionEvent:region forRegionEventType:ACPRegionEventTypeEntry];
}

- (void) locationManager:(CLLocationManager *)manager didExitRegion:(CLRegion *)region {
    [ACPPlaces processRegionEvent:region forRegionEventType:ACPRegionEventTypeExit];
}

Android

In Android, chiama il metodo processGeofence insieme all'evento di transizione appropriato nel ricevitore di trasmissione del recinto geografico. Puoi curare l’elenco dei recinti geografici ricevuti per evitare duplicati di entrate/uscite.

void onGeofenceReceived(final Intent intent) {
    // do appropriate validation steps for the intent
    ...

    // get GeofencingEvent from intent
    GeofencingEvent geoEvent = GeofencingEvent.fromIntent(intent);

    // get the transition type (entry or exit)
    int transitionType = geoEvent.getGeofenceTransition();

    // validate your geoEvent and get the necessary Geofences from the list
    List<Geofence> myGeofences = geoEvent.getTriggeringGeofences();

    // process region events for your geofences
    for (Geofence geofence : myGeofences) {
        Places.processGeofence(geofence, transitionType);
    }
}
recommendation-more-help
475fad96-f29f-4dca-a109-68bf0557e825