Recognize Landmarks with Firebase ML on iOS

You can use Firebase ML to recognize well-known landmarks in an image.

Before you begin

If you have not already added Firebase to your app, do so by following the steps in the getting started guide .

Use Swift Package Manager to install and manage Firebase dependencies.

1. In Xcode, with your app project open, navigate to File > Add Packages .
2. When prompted, add the Firebase Apple platforms SDK repository:

https://github.com/firebase/firebase-ios-sdk.git

3. Choose the Firebase ML library.
4. Add the -ObjC flag to the Other Linker Flags section of your target's build settings.
5. When finished, Xcode will automatically begin resolving and downloading your dependencies in the background.

Next, perform some in-app setup:

1. In your app, import Firebase:

   Swift

    import 
     
    FirebaseMLModelDownloader 
   

   Objective-C

    @import 
     
    FirebaseMLModelDownloader 
    ; 
   

1. If you haven't already enabled Cloud-based APIs for your project, do so now:

   1. Open the Firebase ML APIs page in the Firebase console.

   2. If you haven't already upgraded your project to the pay-as-you-go Blaze pricing plan , click Upgrade to do so. (You'll be prompted to upgrade only if your project isn't on the Blaze pricing plan.)

      Only projects on the Blaze pricing plan can use Cloud-based APIs.

   3. If Cloud-based APIs aren't already enabled, click Enable Cloud-based APIs .

Configure the landmark detector

By default, the Cloud detector uses the stable version of the model and returns up to 10 results. If you want to change either of these settings, specify them with a VisionCloudDetectorOptions object as in the following example:

 let 
  
 options 
  
 = 
  
 VisionCloudDetectorOptions 
 () 
 options 
 . 
 modelType 
  
 = 
  
 . 
 latest 
 options 
 . 
 maxResults 
  
 = 
  
 20 
 
  ViewController 
 . 
 swift 
 
 

  
 FIRVisionCloudDetectorOptions 
  
 * 
 options 
  
 = 
  
 [[ 
 FIRVisionCloudDetectorOptions 
  
 alloc 
 ] 
  
 init 
 ]; 
  
 options 
 . 
 modelType 
  
 = 
  
 FIRVisionCloudModelTypeLatest 
 ; 
  
 options 
 . 
 maxResults 
  
 = 
  
 20 
 ; 
  

In the next step, pass the VisionCloudDetectorOptions object when you create the Cloud detector object.

Run the landmark detector

1. Get an instance of VisionCloudLandmarkDetector :

   Swift

    lazy 
     
    var 
     
    vision 
     
    = 
     
    Vision 
    . 
    vision 
    () 
    let 
     
    cloudDetector 
     
    = 
     
    vision 
    . 
    cloudLandmarkDetector 
    ( 
    options 
    : 
     
    options 
    ) 
    // Or, to use the default settings: 
    // let cloudDetector = vision.cloudLandmarkDetector() 
    ViewController.swift