{"id":26458327,"url":"https://github.com/ProjectDent/ARKit-CoreLocation","last_synced_at":"2025-03-19T00:01:46.797Z","repository":{"id":37759384,"uuid":"97334832","full_name":"AndrewHartAR/ARKit-CoreLocation","owner":"AndrewHartAR","description":"Combines the high accuracy of AR with the scale of GPS data.","archived":false,"fork":false,"pushed_at":"2024-04-19T09:12:26.000Z","size":24021,"stargazers_count":5475,"open_issues_count":47,"forks_count":741,"subscribers_count":196,"default_branch":"develop","last_synced_at":"2024-10-29T15:02:44.792Z","etag":null,"topics":["arkit","augmented-reality","corelocation","gps-data","north-calibration"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AndrewHartAR.png","metadata":{"files":{"readme":"readme.jp.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-07-15T18:29:21.000Z","updated_at":"2024-10-28T02:59:51.000Z","dependencies_parsed_at":"2024-06-18T17:12:03.723Z","dependency_job_id":null,"html_url":"https://github.com/AndrewHartAR/ARKit-CoreLocation","commit_stats":null,"previous_names":["projectdent/arkit-corelocation"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndrewHartAR%2FARKit-CoreLocation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndrewHartAR%2FARKit-CoreLocation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndrewHartAR%2FARKit-CoreLocation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndrewHartAR%2FARKit-CoreLocation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AndrewHartAR","download_url":"https://codeload.github.com/AndrewHartAR/ARKit-CoreLocation/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244326199,"owners_count":20435122,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arkit","augmented-reality","corelocation","gps-data","north-calibration"],"created_at":"2025-03-19T00:01:29.696Z","updated_at":"2025-03-19T00:01:46.768Z","avatar_url":"https://github.com/AndrewHartAR.png","language":"Swift","readme":"![ARKit + CoreLocation](https://github.com/ProjectDent/ARKit-CoreLocation/blob/master/arkit.png)\n\n注) 英語から翻訳したものであり、その内容が最新でない場合もあります。最新の情報はオリジナルの英語版を参照してください。\n\n**ARKit**: カメラとモーションデータを使用して、移動したときに精密に近辺の世界を映し出します。\n\n**CoreLocation**: WifiとGPSを使用して、低い精度で現在地を測定します。\n\n**ARKit + CoreLocation**: ARの高い精度とGPSのスケールを組み合わせます。\n\n![Points of interest demo](https://github.com/ProjectDent/ARKit-CoreLocation/blob/master/giphy-1.gif) ![Navigation demo](https://github.com/ProjectDent/ARKit-CoreLocation/blob/master/giphy-2.gif)\n\nこれらの技術の組み合わせには非常に大きな可能性があり、さまざまな分野に渡って多くの可能性あるアプリケーションがあります。このライブラリには2つの重要な機能が備わっています。\n\n- 現実世界の座標を用いて、ARの世界にアイテムを置けるようにする機能\n- ARの世界を通した動きの知識を組み合わせた最近の位置データを利用した、劇的に改善された位置精度\n\n改善された位置精度は現在、「実験的」な段階にありますが、最も重要な要素になる可能性があります。\n\nやるべきことがまだたくさんあり、他の分野でもそうであるため、GithubのIssueで私たちがやるよりも、このプロジェクトはオープンなコミュニティで提供されるのが最善でしょう。\nなので、このライブラリや改善、自分たちの仕事について議論をするために   誰でも参加できるSlackのグループを開こうと思います。\n\n**[Slackのコミュニティに参加してください](https://join.slack.com/t/arcl-dev/shared_invite/enQtNTk4OTg4MzU0MTEyLTMzYTM0Mjk0YmNkMjgwYzg4OWQ1NDFjNjc3NjM1NzdkNWNkZTc2NjQ1MWFiNmI1MTZiMTA5MmNjZmRiOTk1NjI)**\n\n## 必要条件\nARKitはiOS 11が必要で、以下の端末が対応しています。\n- iPhone 6S and upwards\n- iPhone SE\n- iPad (2017)\n- All iPad Pro models\n\niOS 11 は Apple’s Developer websiteからダウンロードできます。\n\n## 利用方法\nこのライブラリはARKitとCoreLocation frameworkを含んでおり、[Demo 1](https://twitter.com/AndrewProjDent/status/886916872683343872)と似たデモアプリと同様のものです。\n\n[True North calibration のセクションを必ず読んでください。](#true-north-calibration)\n\n### Build設定:\n\n ```bash\nswift build \\\n        -Xswiftc \"-sdk\" -Xswiftc \"`xcrun --sdk iphonesimulator --show-sdk-path`\" \\\n        -Xswiftc \"-target\" -Xswiftc \"x86_64-apple-ios12.1-simulator\"\n```\n\n### Swift Package Managerでの設定\n\n### CocoaPodsでの設定\n1. Podfileに以下を追加:\n\n`pod 'ARCL'`\n\n2. ターミナルでプロジェクトのフォルダまで移動し、以下を入力:\n\n`pod update`\n\n`pod install`\n\n3. `NSCameraUsageDescription` と `NSLocationWhenInUseUsageDescription` を、簡単な説明を入れてplistに追加 (例はデモをご覧ください)\n\n### マニュアルで設定\n1. `ARKit+CoreLocation/Source` からすべてのファイルをプロジェクトに追加.\n2. ARKit、SceneKit、CoreLocation、MapKitをインポート\n3. `NSCameraUsageDescription` と `NSLocationWhenInUseUsageDescription` を、簡単な説明を入れてplistに追加 (例はデモをご覧ください)\n\n### クリックスタートガイド\n例えばロンドンのCanary Wharfなどの、ビルの上にピンを置くためには、ARCLの構築するメインのクラスを使います。 - `SceneLocationView`\n\nまず、ARCLとCoreLocationをインポートします。それから、SceneLocationViewをプロパティとして宣言します。\n\n```swift\nimport ARCL\nimport CoreLocation\n\nclass ViewController: UIViewController {\nvar sceneLocationView = SceneLocationView()\n}\n```\n\nピントが合ってるときはいつでも `sceneLocationView.run()` を呼び、別のビューに移動したりアプリを閉じたりするなどで中断する場合は `sceneLocationView.pause()` を呼ぶべきです。\n\n```swift\noverride func viewDidLoad() {\nsuper.viewDidLoad()\n\nsceneLocationView.run()\nview.addSubview(sceneLocationView)\n}\n\noverride func viewDidLayoutSubviews() {\nsuper.viewDidLayoutSubviews()\n\nsceneLocationView.frame = view.bounds\n}\n```\n\n`run()`を呼んだら、座標を追加することができます。ARCLは`LocationNode`という、3Dシーンのオブジェクトで、現実世界の位置を持ち、3Dの世界の中に適切に表示できるようにする他のいくつかのプロパティも持っているクラスがあります。\n`LocationNode` は SceneKitの`SCNNode`のサブクラスで、さらにサブクラス化できます。例えば、`LocationAnnotationNode`というサブクラスを使います。これは3Dの世界に2次元の画像を表示するために使用しますが、いつも使うことになります。\n\n```swift\nlet coordinate = CLLocationCoordinate2D(latitude: 51.504571, longitude: -0.019717)\nlet location = CLLocation(coordinate: coordinate, altitude: 300)\nlet image = UIImage(named: \"pin\")!\n\nlet annotationNode = LocationAnnotationNode(location: location, image: image)\n```\n\nUIViewを使用して`LocationAnnotationNode`を初期化することも可能です。 \n内部では UIImage に変換されるため、内容を動的に更新することができませんが、UIImage を利用するよりも簡単に複雑なレイアウトを指定できます。\n\n```swift\nlet coordinate = CLLocationCoordinate2D(latitude: 51.504571, longitude: -0.019717)\nlet location = CLLocation(coordinate: coordinate, altitude: 300)\nlet view = UIView() // or a custom UIView subclass\n\nlet annotationNode = LocationAnnotationNode(location: location, view: view)\n```\n\nまた、CALayer を使用して`LocationAnnotationNode`を初期化することも可能です。 \nコンテンツを動的に更新したいような場合に利用するといいでしょう。\n\n```swift\nlet coordinate = CLLocationCoordinate2D(latitude: 51.504571, longitude: -0.019717)\nlet location = CLLocation(coordinate: coordinate, altitude: 300)\nlet layer = CALayer() // or a custom CALayer subclass\n\nlet annotationNode = LocationAnnotationNode(location: location, layer: layer)\n```\n\nデフォルトで、設置した画像は常に与えられたサイズで見えるべきです。例えば、100x100の画像を与えたなら、それはスクリーン上でも100x100で表示されるでしょう。\n遠くにあるアノテーションノードは近くになるのと同じサイズで常に見えるということです。\nもし距離に応じて縮小と拡大をさせる方がいいなら、LocationAnnotationNodeの`scaleRelativeToDistance`を`true`にセットすることができます。\n\n```swift\nsceneLocationView.addLocationNodeWithConfirmedLocation(locationNode: annotationNode)\n```\n\nシーンに位置ノードを追加する方法は2つあります。それは`addLocationNodeWithConfirmedLocation`と`addLocationNodeForCurrentPosition`を使う方法です。端末と同じ位置に位置ノードを3Dの世界に配置し、座標を与えてくれます。\nsceneLocationViewのframeを設定したら、Canary Wharfの上にピンが浮かんでるのが見えます。\n\nノードが`sceneLocationView`によってタッチされたときに、通知を受け取るためにはViewControllerクラスの`LNTouchDelegate`に従う必要があります。`locationNodeTouched（node：AnnotationNode）`は画面に触れたノードへのアクセスを提供します。`AnnotationNode`はSCNNodeのサブクラスであり、` image：UIImage？ `と` view：UIView？ `の2つの追加プロパティがあります。これらのプロパティはどちらも `LocationAnnotationNode`がどのように初期化されたかに基づいて定められます（UIImageまたはUIViewどちらかのコンストラクタを使ったかによって定められます）。\n\n```swift\nclass ViewController: UIViewController, LNTouchDelegate {\n    override func viewDidLoad() {\n        super.viewDidLoad()\n        //...\n        self.sceneLocationView.locationNodeTouchDelegate = self\n        //...\n    }\n    func locationNodeTouched(node: AnnotationNode) {\n        // Do stuffs with the node instance\n\n        // node could have either node.view or node.image\n        if let nodeView = node.view{\n            // Do stuffs with the nodeView\n            // ...\n        }\n        if let nodeImage = node.image{\n            // Do stuffs with the nodeImage\n            // ...\n        }\n    }\n}\n```\n\n## 追加機能\nライブラリとデモには、設定のための追加の機能が用意されています。必ず一覧できるように完全に文書化されています。\n\nSceneLocationViewはARSCNViewのサブクラスです. 別の方法で完全にARSCNViewを使えるようにしてくれる一方で、別のクラスにdelegateをセットすべきではないことを留意してください。もしdelegateの機能が必要になったら、サブクラスの`SceneLocationView`を使ってください。\n\n## True North calibration\n私が個人的に解決できなかった問題は、iPhoneのTrue North calibrationが現在最高で15度の精度であるということです。これは地図のナビにとっては良いのですが、ARの世界に物体を置くときには、問題となりはじめます。\n\n私はこの問題は、様々なARの技術によって乗り越えられると確信しています。それは共同して恩恵を受けることができると思う1つの領域です。\n\n現在これを改善するために、私は北点を調整できるようにするいくつかの機能をライブラリに追加してきました。\n`sceneLocationView.useTrueNorth`を`false`に設定することでこれらを使用します。それから、最初に端末を北の一般的な方向に向けると、合理的に近づけることができます。`UseTrueNorth`をtrue（デフォルト）に設定すると、北をうまく検知できるようになるにつれて調整を続けていきます。\n\nデモアプリ内では、`adjustNorthByTappingSidesOfScreen`という利用できないプロパティがあります。これは上記の機能にアクセスできるのですが、一度利用できるようにすれば、スクリーンの左側と右側をタップすることでシーンの進行方向を調整できるようになります。\n\n自分の位置から直接的にTrue Northとなっている近くの目印を正確にし、座標を使ってそこに物体を設置し、その物体が目印に並んで表示されるまでシーンを調整する`moveSceneHeading`を使います。\n\n## 位置精度の改善\nCoreLocationは1~15秒ごとにどこでも位置の更新を伝えてくれますが、精度は150mから4mまで変化します。不正確な位置の読み取りに戻ってしまう前に、ときどき4mや8mのようにより正確な位置を取得することがあるでしょう。それと同時に、ARはモーションやカメラのデータを使ってARの世界での地図を作ります。\n\nユーザーは4mまで正確な位置の読み取りを受信することがあります。その後、ユーザーが10m北に歩き、65mまで正確に読み取られた別の位置を取得します。この65mでの正確な読み取りはCoreLicationが提供できる最高のものなのですが、4mが読み取られたときにAR内でのユーザーの位置を把握し、そこからARを10m北に歩いたら、およそ4mの精度で新しい座標を与えてくれるデータに変換することができます。これは100mまで正確になります。\n\n[より詳細な情報はwikiにあります。](https://github.com/ProjectDent/ARKit-CoreLocation/wiki/Current-Location-Accuracy).\n\n### 問題\nこれは実験的だと言いましたが、現在はユーザーがARを使って歩いてるときにARKitがときどき混乱し、ユーザーの位置が不正確になるかもしれません。この問題は\"オイラー角\"または端末の向きの情報に影響するようにも見えます。なので、少し距離を進んだ後は、あなたが別の方角を歩いてるとARKitは思うのかもしれません。\n\nAppleがそのうちARKitを改善する一方で、それらの問題を回避するために私たちでできる改善があると思っています。例えば問題が起きたことを認識し、修正することなど。これは位置データを想定した位置と比較して、想定した範囲を超えて移動したのかどうかを判定することで実現できます。\n\n### 位置のアルゴリスムの改善\nユーザの位置を決定するためにさらなる最適化をすることができます。\n\n例えば、最近の位置データを見て、その後のユーザーの移動をもとに各データポイントを変換し、ユーザがいそうな位置をより厳しく判定するためにそのデータポイントの重なりを使うというテクニックです。\n\n[より詳細な情報はwikiにあります。](https://github.com/ProjectDent/ARKit-CoreLocation/wiki/Current-Location-Accuracy).\n\n## 今後\n\n私たちは、いくつかのマイルストーンと上記に関連した問題を抱えています。議論したり貢献することは誰でも歓迎です。心おきなくプルリクエストを送ってください。新しくIssueを追加するか[the Slack community](https://join.slack.com/t/arcl-dev/shared_invite/MjE4NTQ3NzE3MzgxLTE1MDExNTAzMTUtMTIyMmNlMTkyYg)で新しい機能/拡張/バグについて議論できます。\n\n## Thanks\n[@AndrewProjDent](https://twitter.com/andrewprojdent)がライブラリをつくりましたが、コミュニティの努力はここからです。\n\n[MIT License](http://opensource.org/licenses/MIT)の条件でオープンソースとして利用できます。\n\n","funding_links":[],"categories":["Augmented Reality [🔝](#readme)","Libs","AR","Swift","ARKit","Projects","north-calibration","Libraries/Frameworks/Tools"],"sub_categories":["Augmented Reality","Other free courses","Getting Started"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FProjectDent%2FARKit-CoreLocation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FProjectDent%2FARKit-CoreLocation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FProjectDent%2FARKit-CoreLocation/lists"}