DokumentationMobile SDKPlaces Service-Anleitung

Verwenden eines eigenen Monitors using-your-monitor

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Sie können auch Ihre Monitoring-Services verwenden und die Integration mit dem Places-Service mithilfe der Places-Erweiterungs-APIs durchführen.

Geofences registrieren

Wenn Sie sich für die Verwendung Ihrer Monitoring-Services entscheiden, registrieren Sie die Geofences der POIs um Ihren aktuellen Standort, indem Sie die folgenden Schritte ausführen:

iOS

Führen Sie in iOS die folgenden Schritte aus:

  1. Übergeben Sie die Standortaktualisierungen, die von den zentralen Standortdiensten der iOS abgerufen wurden, an die Places-Erweiterung.

  2. Verwenden Sie die API der getNearbyPointsOfInterest Places-Erweiterung, um das Array der ACPPlacesPoi Objekte um den aktuellen Speicherort abzurufen.

    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. Extrahieren Sie die Informationen aus den abgerufenen ACPPlacesPOI und beginnen Sie mit der Überwachung dieser POIs.

    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. Übergeben Sie die Standortaktualisierungen, die von den Google Play-Services oder den Android-Standortdiensten abgerufen wurden, an die Places-Erweiterung.

  2. Verwenden Sie die API der getNearbyPointsOfInterest Places-Erweiterung, um die Liste der PlacesPoi Objekte um den aktuellen Speicherort abzurufen.

    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. Extrahieren Sie die Daten aus den abgerufenen PlacesPOI und beginnen Sie mit der Überwachung dieser POIs.

    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)
}

Der Aufruf der getNearbyPointsOfInterest-API führt zu einem Netzwerkaufruf, der den Speicherort um den aktuellen Speicherort abruft.

IMPORTANT
Sie sollten die API sparsam oder nur aufrufen, wenn sich der Standort des Benutzers erheblich ändert.

Geofence-Ereignisse posten

iOS

Rufen Sie in iOS die processGeofenceEvent Places-API im CLLocationManager auf. Diese API informiert Sie darüber, ob der Benutzer in eine bestimmte Region eingetreten ist oder diese verlassen hat.

- (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

Rufen Sie in Android die processGeofence-Methode zusammen mit dem entsprechenden Übergangsereignis in Ihrem Geofence-Rundfunkempfänger auf. Sie können die Liste der empfangenen Geofences kuratieren, um doppelte Ein-/Austritte zu verhindern.

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