Mengelola Geoqueries dengan ParseGeoPoint di ParseSwift SDK

9min
Geoqueries
Pendahuluan
Kami menggunakan istilah Geoqueries untuk merujuk pada jenis kueri di mana kondisi mereka melibatkan ParseGeoPoint jenis bidang. Disarankan untuk menggunakan ParseGeoPoint struktur untuk menyimpan data lokasi geografis di Database Back4App. ParseSwift SDK menyediakan serangkaian metode yang memungkinkan kami untuk mengkueri data sesuai dengan kondisi yang diterapkan pada ParseGeoPointtipe data.
Prasyarat
Untuk menyelesaikan tutorial ini, Anda akan membutuhkan:
Sebuah Aplikasi dibuat di Back4App.
Sebuah Aplikasi iOS dasar untuk menguji kueri
Tujuan
Untuk memahami cara mengkueri data menggunakan kondisi pada data lokasi geografis.
- Tinjauan cepat tentang Kelas Query<U>
Setiap kueri yang dilakukan pada Database Back4App dilakukan melalui kelas generik Query<U>. Parameter generik U (yang sesuai dengan ParseObject protokol) adalah tipe data dari objek yang ingin kami ambil dari database.
Diberikan tipe data seperti MyObject, kita mengambil objek-objek ini dari Database Back4App dengan cara berikut
Swift
 import ParseSwift
2
 struct MyObject: ParseObject {
   ...
 }
6
 let query = MyObject.query()
8
 // Executes the query asynchronously
query.find { result in
  // Handle the result (of type Result<[MyObject], ParseError>)
}
 import ParseSwift
2
 struct MyObject: ParseObject {
   ...
 }
6
 let query = MyObject.query()
8
 // Executes the query asynchronously
query.find { result in
  // Handle the result (of type Result<[MyObject], ParseError>)
}
﻿
Anda dapat membaca lebih lanjut tentang Query<U> kelas di sini pada dokumentasi resmi.
- Simpan beberapa data di Back4App
Sebelum kita mulai mengeksekusi kueri, kita harus menyimpan beberapa data contoh di Database Back4App. Dengan mengikuti Panduan Cepat, Anda dapat mengonfigurasi dan menghubungkan Aplikasi iOS contoh Anda ke database Back4App Anda. Untuk panduan ini, kita akan menyimpan informasi tentang kota. Kita menggunakan struktur berikut untuk mengorganisir informasi kota:
Swift
 import ParseSwift
2
 struct City: ParseObject {
     ...
  
     var name: String? // City's name
     var location: ParseGeoPoint? // It will store the city's coordinate on Earth
 }
 import ParseSwift
2
 struct City: ParseObject {
     ...
  
     var name: String? // City's name
     var location: ParseGeoPoint? // It will store the city's coordinate on Earth
 }
﻿
Sekarang, kita melanjutkan untuk menyimpan data sampel. Langkah ini dapat diimplementasikan menggunakan Swift atau langsung dari konsol aplikasi Anda di platform Back4App. 
Swift
Back4App's console
//A quick way to insert elements on your Back4App Database is via the console located in your App’s API section. Once you are there, you can start running Javascript code to save the sample data
 // Add City objects and create table
 // Note how GeoPoints are created, passing latitude and longitude as arguments
 // Montevideo
 City = new Parse.Object('City');
 City.set('name', 'Montevideo - Uruguay');
 City.set('location', new Parse.GeoPoint(-34.85553195363169, -56.207280375137955));
 await City.save();
8
 // Brasília
City = new Parse.Object('City');
City.set('name', 'Brasília - Brazil');
City.set('location', new Parse.GeoPoint(-15.79485821477289, -47.88391074690196));
await City.save();
14
// Bogotá
City = new Parse.Object('City');
City.set('name', 'Bogotá - Colombia');
City.set('location', new Parse.GeoPoint(4.69139880891712, -74.06936691331047));
await City.save();
20
// Mexico City
City = new Parse.Object('City');
City.set('name', 'Mexico City - Mexico');
City.set('location', new Parse.GeoPoint(19.400977162618933, -99.13311378164776));
await City.save();
26
// Washington, D.C.
City = new Parse.Object('City');
City.set('name', 'Washington, D.C. - USA');
City.set('location', new Parse.GeoPoint(38.930727220189944, -77.04626261880388));
await City.save();
32
// Ottawa
City = new Parse.Object('City');
City.set('name', 'Ottawa - Canada');
City.set('location', new Parse.GeoPoint(45.41102167733425, -75.695414598736));
await City.save();
//A quick way to insert elements on your Back4App Database is via the console located in your App’s API section. Once you are there, you can start running Javascript code to save the sample data
 // Add City objects and create table
 // Note how GeoPoints are created, passing latitude and longitude as arguments
 // Montevideo
 City = new Parse.Object('City');
 City.set('name', 'Montevideo - Uruguay');
 City.set('location', new Parse.GeoPoint(-34.85553195363169, -56.207280375137955));
 await City.save();
8
 // Brasília
City = new Parse.Object('City');
City.set('name', 'Brasília - Brazil');
City.set('location', new Parse.GeoPoint(-15.79485821477289, -47.88391074690196));
await City.save();
14
// Bogotá
City = new Parse.Object('City');
City.set('name', 'Bogotá - Colombia');
City.set('location', new Parse.GeoPoint(4.69139880891712, -74.06936691331047));
await City.save();
20
// Mexico City
City = new Parse.Object('City');
City.set('name', 'Mexico City - Mexico');
City.set('location', new Parse.GeoPoint(19.400977162618933, -99.13311378164776));
await City.save();
26
// Washington, D.C.
City = new Parse.Object('City');
City.set('name', 'Washington, D.C. - USA');
City.set('location', new Parse.GeoPoint(38.930727220189944, -77.04626261880388));
await City.save();
32
// Ottawa
City = new Parse.Object('City');
City.set('name', 'Ottawa - Canada');
City.set('location', new Parse.GeoPoint(45.41102167733425, -75.695414598736));
await City.save();
﻿
- Kuery data
Mengurutkan hasil
Dengan data contoh yang disimpan, kita dapat mulai melakukan berbagai jenis kueri.
Untuk contoh pertama kita, kita akan memilih semua kota dan mengurutkannya tergantung seberapa jauh mereka dari titik geopoint referensi. Kita mengimplementasikan kueri ini dengan memberikan batasan pada Query<City> objek. Metode near(key:geoPoint:) yang tersedia melalui ParseSwift SDK memungkinkan kita untuk membangun batasan tersebut. Sebagai argumen, kita memberikan nama field (biasanya disebut sebagai key) yang berisi geoPoint referensi.
Swift
 // The reference geopoint will be Kingston city - Jamaica
 guard let kingstonGeoPoint = try? ParseGeoPoint(latitude: 18.018086950599134, longitude: -76.79894232253473) else { return }
3
 let query = City.query(near(key: "location", geoPoint: kingstonGeoPoint)) // The method near(key:geoPoint:) returns the constraint needed to sort the query
5
 let sortedCities: [City]? = try? query.find() // Executes the query synchronosuly and returns an array containing the cities properly sorted
7
 query.find { result in // Executes the query asynchronosuly and returns a Result<[City], ParseError> type object to handle the results
   switch result {
  case .success(let cities):
    // cities = [Bogotá, Washington DC, Mexico City, Ottawa, Brasília, Montevideo]
  case .failure(let error):
    // Handle the error if something happened
  }
}
 // The reference geopoint will be Kingston city - Jamaica
 guard let kingstonGeoPoint = try? ParseGeoPoint(latitude: 18.018086950599134, longitude: -76.79894232253473) else { return }
3
 let query = City.query(near(key: "location", geoPoint: kingstonGeoPoint)) // The method near(key:geoPoint:) returns the constraint needed to sort the query
5
 let sortedCities: [City]? = try? query.find() // Executes the query synchronosuly and returns an array containing the cities properly sorted
7
 query.find { result in // Executes the query asynchronosuly and returns a Result<[City], ParseError> type object to handle the results
   switch result {
  case .success(let cities):
    // cities = [Bogotá, Washington DC, Mexico City, Ottawa, Brasília, Montevideo]
  case .failure(let error):
    // Handle the error if something happened
  }
}
﻿
Memilih hasil dalam wilayah tertentu
Misalkan kita ingin memilih kota-kota dalam wilayah tertentu. Kita dapat mencapainya dengan batasan yang dibuat oleh metode withinKilometers(key:geoPoint:distance:). Sebagai argumen, kita mengirimkan nama field yang berisi lokasi kota, pusat wilayah (sebuah ParseGeoPoint tipe data) dan jarak maksimum (dalam km) sebuah kota dapat berada dari pusat wilayah ini. Untuk memilih semua kota yang paling jauh 3000km dari Kingston - Jamaika, kita dapat melakukannya dengan cara berikut
Swift
 let distance: Double = 3000 // km
 guard let kingstonGeoPoint = try? ParseGeoPoint(latitude: 18.018086950599134, longitude: -76.79894232253473) else { return }
3
 let query = City.query(withinKilometers(key: "location", geoPoint: kingstonGeoPoint, distance: distance))
 // The method withinKilometers(key:geoPoint:distance:) returns the constraint we need for this case
6
 let sortedCities: [City]? = try? query.find() // Executes the query synchronosuly and returns an array containing the cities we are looking for (Bogotá, Washington DC and Mexico city in this case)
8
 query.find { result in // Executes the query asynchronosuly and returns a Result<[City], ParseError> type object to handle the results
  switch result {
  case .success(let cities):
    // cities = [Bogotá, Washington DC, Mexico City]
  case .failure(let error):
    // Handle the error if something happened
  }
}
 let distance: Double = 3000 // km
 guard let kingstonGeoPoint = try? ParseGeoPoint(latitude: 18.018086950599134, longitude: -76.79894232253473) else { return }
3
 let query = City.query(withinKilometers(key: "location", geoPoint: kingstonGeoPoint, distance: distance))
 // The method withinKilometers(key:geoPoint:distance:) returns the constraint we need for this case
6
 let sortedCities: [City]? = try? query.find() // Executes the query synchronosuly and returns an array containing the cities we are looking for (Bogotá, Washington DC and Mexico city in this case)
8
 query.find { result in // Executes the query asynchronosuly and returns a Result<[City], ParseError> type object to handle the results
  switch result {
  case .success(let cities):
    // cities = [Bogotá, Washington DC, Mexico City]
  case .failure(let error):
    // Handle the error if something happened
  }
}
﻿
Selain itu, ketika jarak diberikan dalam mil alih-alih kilometer, kita dapat menggunakan withinMiles(key:geoPoint:distance:sorted:) metode.
Metode yang kurang umum, withinRadians(key:geoPoint:distance:sorted:), juga tersedia jika jarak diberikan dalam radian. Penggunaannya sangat mirip dengan metode sebelumnya.
Memilih hasil dalam poligon yang diberikan
Dalam contoh sebelumnya, kami memilih kota-kota dalam suatu wilayah yang diwakili oleh wilayah berbentuk lingkaran. Jika kami memerlukan bentuk non-lingkaran untuk wilayah tersebut, ParseSwift SDK memungkinkan kami untuk membangun wilayah tersebut dari titik-titik sudutnya.
Sekarang, tujuan dari contoh ini adalah untuk memilih kota-kota dalam poligon dengan lima titik. Titik-titik ini dinyatakan menggunakan ParseGeoPoint struct. Setelah kita membuat titik-titik tersebut, kita menginstansiasi ParsePolygon. Poligon ini kemudian diteruskan ke withinPolygon(key:polygon:) metode (yang disediakan oleh ParseSwift SDK) untuk membangun batasan yang akan memungkinkan kita untuk memilih kota-kota dalam poligon ini.
Swift
 // The polygon where the selected cities are
 let polygon: ParsePolygon? = {
   do {
     // We first instantiate the polygon vertices
     let geoPoint1 = try ParseGeoPoint(latitude: 15.822238344514378, longitude: -72.42845934415942)
     let geoPoint2 = try ParseGeoPoint(latitude: -0.7433770196268968, longitude: -97.44765968406668)
     let geoPoint3 = try ParseGeoPoint(latitude: -59.997149373299166, longitude: -76.52969196322749)
     let geoPoint4 = try ParseGeoPoint(latitude: -9.488786415007201, longitude: -18.346101586021952)
     let geoPoint5 = try ParseGeoPoint(latitude: 15.414859532811047, longitude: -60.00625459569375)
              
    // Next we compose the polygon
    return try ParsePolygon([geoPoint1, geoPoint2, geoPoint3, geoPoint4, geoPoint5])
  } catch let error as ParseError {
    print("Failed to instantiate vertices: \(error.message)")
    return nil
  } catch {
    print("Failed to instantiate vertices: \(error.localizedDescription)")
    return nil
  }
}()
      
guard let safePolygon = polygon else { return }
      
let query = City.query(withinPolygon(key: "location", polygon: safePolygon))
// withinPolygon(key:polygon:) returns the required constraint to apply on the query
      
let cities = try? query.find() // Executes the query synchronously
      
query.find { result in // Executes the query asynchronously and returns a result of type Result<[], ParseError>
  // Handle the result
}
 // The polygon where the selected cities are
 let polygon: ParsePolygon? = {
   do {
     // We first instantiate the polygon vertices
     let geoPoint1 = try ParseGeoPoint(latitude: 15.822238344514378, longitude: -72.42845934415942)
     let geoPoint2 = try ParseGeoPoint(latitude: -0.7433770196268968, longitude: -97.44765968406668)
     let geoPoint3 = try ParseGeoPoint(latitude: -59.997149373299166, longitude: -76.52969196322749)
     let geoPoint4 = try ParseGeoPoint(latitude: -9.488786415007201, longitude: -18.346101586021952)
     let geoPoint5 = try ParseGeoPoint(latitude: 15.414859532811047, longitude: -60.00625459569375)
              
    // Next we compose the polygon
    return try ParsePolygon([geoPoint1, geoPoint2, geoPoint3, geoPoint4, geoPoint5])
  } catch let error as ParseError {
    print("Failed to instantiate vertices: \(error.message)")
    return nil
  } catch {
    print("Failed to instantiate vertices: \(error.localizedDescription)")
    return nil
  }
}()
      
guard let safePolygon = polygon else { return }
      
let query = City.query(withinPolygon(key: "location", polygon: safePolygon))
// withinPolygon(key:polygon:) returns the required constraint to apply on the query
      
let cities = try? query.find() // Executes the query synchronously
      
query.find { result in // Executes the query asynchronously and returns a result of type Result<[], ParseError>
  // Handle the result
}
﻿
Kesimpulan
Saat ini melakukan operasi pada data lokasi untuk menawarkan layanan kustom sangat penting. Back4App bersama dengan ParseSwift SDK memudahkan untuk menerapkan jenis operasi tersebut.
Diperbarui 27 Jan 2025
Apakah halaman ini membantu Anda?
SEBELUMNYA
Kuery Data Relasional dengan ParseSwift di iOS
BERIKUTNYA
Implementasi Pendaftaran Pengguna di iOS dengan ParseSwift
Mengelola Geoqueries dengan ParseGeoPoint di ParseSwift SDK

Geoqueries

Pendahuluan

Prasyarat

Tujuan

1 - Tinjauan cepat tentang Kelas Query<U>

2 - Simpan beberapa data di Back4App

3 - Kuery data

Kesimpulan
