地理空間錨點是一種錨點，可讓您在現實世界中放置 3D 內容。
地理空間錨點的類型
地理空間錨點有三種類型，每種類型處理高度的方式皆不同：
WGS84 錨點：
WGS84 錨點可用於在任何指定的經緯度及海拔高度上放置 3D 內容。地形錨點：
地形錨點可讓您僅使用經緯度 (且相對於特定位置的地形的高度) 放置內容。 海拔高度是以 VPS 所稱的地面或樓層為依據。屋頂錨點：
屋頂錨點可讓您僅使用經緯度 (相對於該位置建築物屋頂的高度) 放置內容。海拔高度是以街景幾何圖形所稱的建築物頂端為準。如此一來，如果不放置在建築物上，就會預設為地形高度。
| WGS84 | 地形 | 屋頂 | |
|---|---|---|---|
| 水平位置 | 緯度, 經度 | 緯度, 經度 | 緯度, 經度 |
| 垂直位置 | 相對於 WGS84 高度 | 相對於 Google 地圖判定的地形等級 | 相對於 Google 地圖判定的頂樓樓層 |
| 需要由伺服器解析嗎？ | 否 | 是 | 是 |
必要條件
請務必先啟用 Geospatial API 再繼續操作。
地點地理空間錨點
每種錨點類型都有用來建立的專屬 API；詳情請參閱「地理空間錨點類型」一文。
根據命中測試建立錨定廣告
您也可以透過命中測試結果建立地理空間錨點。使用命中測試的轉換，並將其轉換為 GARGeospatialTransform。用它來放入上述 3 種錨定類型中任一種。
從 AR 轉換取得地理空間轉換
GARSession.geospatialTransformFromTransform:error: 可將 AR 轉換轉換為地理空間轉換，透過另一種方式判斷經緯度。
從地理空間轉換取得 AR 轉換
GARSession.transformFromGeospatialCoordinate:altitude:eastUpSouthQTarget:error: 會將相對於東南方座標框架的地球指定的水平位置、高度和四元數旋轉角度，轉換成與 GL 世界座標相關的 AR 轉換。
依照您的用途選擇適合的方法
每種建立錨點的方法各不相同，請特別留意：
- 使用街景幾何圖形時，請使用命中測試將內容附加至建築物。
- 優先使用地形或屋頂錨點在 WGS84 錨點上，因為它們會使用 Google 地圖決定的高度值。
判斷地點的經緯度
有三種方式可以計算地點的經緯度：
- 使用地理空間建立者工具，不必實際前往任何地點，也能透過 3D 內容觀看世界並擴張世界。您可以在 Unity 編輯器中使用 Google 地圖，以視覺化方式呈現 3D 沉浸式內容。系統會自動計算內容的經緯度、旋轉和高度。
- 使用 Google 地圖
- 使用 Google 地球。請注意，使用 Google 地球 (而不是 Google 地圖) 取得這些座標時，會產生高達幾公尺的誤差範圍。
- 前往實體位置
使用 Google 地圖
如何使用 Google 地圖取得指定地點的經緯度：
透過電腦前往 Google 地圖。
依序前往「圖層」 >「更多」。
將「地圖類型」變更為「衛星」，並取消勾選畫面左下角的「地球檢視」核取方塊。
這會強制執行 2D 透視，並排除角度 3D 檢視畫面可能出現的錯誤。
在地圖上按一下滑鼠右鍵，然後選取經緯度，即可複製到剪貼簿。
使用 Google 地球
您可以透過 Google 地球計算某地點的經緯度，方法是按一下使用者介面中的某個位置，然後讀取地標詳細資料中的資料。
如何使用 Google 地球取得特定地點的經緯度：
在電腦上前往 Google 地球。
前往漢堡選單
，然後選取「地圖樣式」。關閉「3D 建築物」開關。
關閉「3D 建築物」開關後，按一下圖釘圖示
，即可在所選位置新增地標。指定要包含地標的專案，然後按一下「儲存」。
在地標的「標題」欄位中，輸入地標的名稱。
按一下專案窗格中的返回箭頭
，然後選取 
「More Actions」選單。在選單中選擇「匯出為 KML 檔案」。
KLM 檔案會回報 <coordinates> 標記中以半形逗號隔開地標的經緯度和海拔高度，如下所示：
<coordinates>-122.0755182435043,37.41347299422944,7.420342565583832</coordinates>
請勿使用 <LookAt> 標記中的經緯度，因為該標記可指定攝影機位置，而不是位置。
前往實體位置
您可以親自前往當地進行當地觀察，藉此計算特定地點的海拔高度。
取得旋轉四元數
GARGeospatialTransform.eastUpSouthQTarget 會從地理空間轉換中擷取方向，並輸出四元數，用來表示將目標從目標轉換到東南方 (EUS) 座標系統的旋轉矩陣。東方 X 點以上、Y 點以上，南邊是 Z+ 點。值會依順序 {x, y, z, w} 寫入。
WGS84 錨點
WGS84 Anchor 是一種錨定類型，可讓您以任何指定經緯度和海拔高度放置 3D 內容。要放置在真實世界中，就必須有變形和方向。位置由 WGS84 座標系統中指定的經緯度和海拔高度組成。方向包含四元數旋轉。
海拔高度是以公尺為單位記錄在參考 WGS84 橢球體上方，因此地面高度「不」為零。您的應用程式負責為每個建立的錨點提供這些座標。
在現實世界中放置 WGS84 錨點
判斷地點的海拔高度
您可以透過下列幾種方式判斷地點放置錨點的海拔高度：
- 如果錨點的位置在使用者接近使用者的位置，您可以採用與使用者裝置高度類似的海拔高度。
- 取得經緯度後，請使用 Elevation API 取得根據 EGM96 規格的海拔高度。您必須將 Maps API EGM96 高度轉換為 WGS84，才能與
GARGeospatialTransform高度進行比較。請參閱同時擁有指令列和 HTML 介面的 GeoidEval。Maps API 會根據 WGS84 規格回報經緯度。 - 您可以透過 Google 地球取得特定地點的經緯度和海拔高度。這樣就能收到高達數公尺的誤差範圍。在 KML 檔案中使用
<coordinates>標記的經緯度和海拔高度，而「不是」<LookAt>標記。 - 如果現有錨點相近 且您不在陡峭的斜坡上，或許可以使用相機
GARGeospatialTransform的海拔高度，而無需使用其他來源，例如 Maps API。
建立錨定標記
取得經緯度、海拔高度和旋轉四元數後，請使用 createAnchorWithCoordinate:altitude:eastUpSouthQAnchor:error: 將內容固定至您指定的地理座標。
NSError *error = nil;
GARAnchor *anchor = [self.garSession createAnchorWithCoordinate:coordinate
altitude:altitude
eastUpSouthQAnchor:eastUpSouthQAnchor
error:&error];
地形錨點
地形錨點是一種錨點，可讓您只使用經緯度放置 AR 物件，透過 VPS 的資訊找出地面上精確的海拔高度。
您提供的是地形上方的海拔高度，而不是輸入所需的高度。這個值為零時，錨點將與地形水平一致。
設定飛機尋找模式
飛機發現項目為選用項目，並非使用錨點的必要項目。請注意，只能使用水平平面。水平平面有助於讓地形錨點在地面上的動態對齊。
使用 ARWorldTrackingConfiguration.PlaneDetection 選取應用程式偵測飛機的方式。
使用新的 Async API 建立地形錨定標記
如要建立並放置地形錨定標記，請呼叫 GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error:。
錨點不會立即就緒，需要解析。問題解決後，GARCreateAnchorOnTerrainFuture就會顯示相關問題。
GARCreateAnchorOnTerrainFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
altitudeAboveTerrain:altitude
eastUpSouthQAnchor:eastUpSouthQTarget
completionHandler:^(GARAnchor *anchor, GARTerrainAnchorState state) {
// handle completion
}
error:&error];
查詢未來的狀態
Future 會有一個相關聯的 GARFutureState。
| 狀態 | 說明 |
|---|---|
GARFutureStatePending |
作業仍待處理。 |
GARFutureStateDone |
作業已完成，且有結果。 |
GARFutureStateCancelled |
操作已取消。 |
查看 Future 結果的地形錨點狀態
GARTerrainAnchorState 屬於非同步作業，並且是最終 Future 結果的一部分。
switch (future.resultTerrainAnchorState) {
case GARTerrainAnchorStateSuccess:
// Terrain anchor finished resolving.
break;
case GARTerrainAnchorStateErrorUnsupportedLocation:
// The requested anchor is in a location that isn't supported by the Geospatial API.
break;
case GARTerrainAnchorStateErrorNotAuthorized:
// An error occurred while authorizing your app with the ARCore API. See
// https://developers.google.com/ar/reference/ios/group/GARTerrainAnchorState#garterrainanchorstateerrornotauthorized
// for troubleshooting steps.
break;
case GARTerrainAnchorStateErrorInternal:
// The Terrain anchor could not be resolved due to an internal error.
break;
default:
break;
}
屋頂錨點
屋頂錨點屬於錨點類型，與上述的地形錨點非常類似。差別在於您提供的是屋頂的海拔高度，而不是地形上方的海拔高度。
使用新的 Async API 建立 Rooftop 錨點
錨點不會立即就緒，需要解析。
如要建立並放置屋頂錨點，請呼叫 GARSession.createAnchorWithCoordinate:altitudeAboveRooftop:eastUpSouthQAnchor:completionHandler:error:。與地形錨點類似，您也存取 Future 的 GARFutureState。然後查看「未來」結果即可存取 GARRooftopAnchorState。
GARCreateAnchorOnRooftopFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
altitudeAboveRooftop:altitude
eastUpSouthQAnchor:eastUpSouthQTarget
completionHandler:^(GARAnchor *anchor, GARRooftopAnchorState state) {
// handle completion
}
error:&error];
查詢未來的狀態
Future 會產生相關聯的 GARFutureState，請參閱上方的表格。
查看 Future 結果的屋頂錨點狀態
GARRooftopAnchorState 屬於非同步作業，並且是最終 Future 結果的一部分。
switch (future.resultRooftopAnchorState) {
case GARRooftopAnchorStateSuccess:
// Rooftop anchor finished resolving.
break;
case GARRooftopAnchorStateErrorUnsupportedLocation:
// The requested anchor is in a location that isn't supported by the Geospatial API.
break;
case GARRooftopAnchorStateErrorNotAuthorized:
// An error occurred while authorizing your app with the ARCore API. See
// https://developers.google.com/ar/reference/ios/group/GARRooftopAnchorState#garrooftopanchorstateerrornotauthorized
// for troubleshooting steps.
break;
case GARRooftopAnchorStateErrorInternal:
// The Rooftop anchor could not be resolved due to an internal error.
break;
default:
break;
}
後續步驟
- 請務必瞭解地理空間的 API 使用配額。