iOSでYandex MapKitを更新した方法、またはマップ、お金、2つのマップピットの物語

まえがき

はじめまして 、この記事の目的を簡単に説明します。iOSモバイルクライアントでYandexマップを更新または埋め込む必要がある場合に時間を節約し、経験を共有したいという欲求。



電子メールカード（個人用ではなく、ビジネスのみ）の代わりに、YandexMapkitアプリケーション（2017年10月頃）を組み込みました。 約3か月後、美しい冬の日に、キーのせいでカードのアンドロイド版が2日目に故障しました。カードはカボチャになっただけです。 iOSクライアントとして、これは影響しませんでした。 アンドロードの貧しい人々...今回は、彼らは何の関係もありませんでした。 当時、多くのロッジが倒れました ：ロシアのポスト、カモノハシ、多分あなたたちは覚えていますか？







これは、アプリケーションがサードパーティのサービスに関連付けられている場合、たとえば、Appleのカードの実装を以前のバージョンに切り替えて、別のカードに置き換えるのではなく、この場合のプラン「B」があると便利だということです...



さらに3か月後、3月のどこかで、Yandexから、最終的にSDKを更新したという手紙が届きました（前の更新から約4〜5年後）。

「-更新、1年で古いものをオフにする」、要するに。 その前に、単に古いバージョン1.0がありました







まあ、もちろん、そのような警告の後、私たちは引っ張らず、すぐに移行を開始しました... 3月後）8月に）。

「コメント」の段階！（機能の無効化）

あなたは私に言った、ハ...そこで更新されるもの、ポッドが更新される、いくつかの場所を修正する、それだけです。 いいえ、新しいマップAPIは古いものと完全に互換性がありません。さらに、後で判明したように、古いバージョンや他のカードライブラリにはすぐに使用できる重要な必需品もたくさんあります。



したがって、mapkit 3.0（記事の執筆中にバージョン3.1がリリースされました）、 ドキュメントへのリンクです。



そして、なぜYandexからの警告に加えて？ 一方、Xcode 10のベータ版では、古いバージョンのクジラを使用したプロジェクトは、C ++が内部のどこかで使用されており、新しいバージョンでは非難されているため、愚かには行きません。 サブリストで名前を変更する必要があり、そこで更新することさえ必要です。要するに、結局は更新する必要があるので、私はこれをしませんでした。



1）バージョン1.0ではなく、すぐに3.0にSDKを更新します。もちろんAPIは変更されましたが、...



そのため、古いYMKAnnotation Protocolは単純に欠落しています









迅速に、それは強制鍛造strigのように見えます（：それは賑やかではなく、「！」記号はあなたのためにそのように扱われます...プロトコル実装の例：







さて、私たち自身で、座標（）メソッドの代わりにプロパティを作成します。すべてがシンプルで、メソッドは冗長です。 title！（）は未形成のタイトル（）に置き換えられますが、一方で、プロパティを作成することもできます。プロジェクトを変更する必要がある場所がたくさんあるので、感嘆符を削除しました。



プロジェクトでは、Yandex MapPocketヘッダーのいずれにもインポートされないため、3つのコントローラーを数回交換し、別のコントローラーにCoreLocationをインポートする必要がありました。



プロジェクト全体で使い慣れたYMKMapCoordinate（古いクジラ）の名前を変更しないように、YMKPoint（新しいクジラ）のタイプエイリアスを作成しました







2）また、マップを操作するために将来必要になるいくつかのプロパティ、主にゲッターを宣言しましょう：







3）最初に作成するのはYMKMapViewです（すべて問題ありません。そのようなオブジェクトはまだ利用可能です）。 以前、私はすぐにそれを初期化しました、今あなたはこれをすることができません、最初にキーを置く必要があるので、それはクラッシュします！ 現在のキーは機能しないため、新しいキーを要求する必要があります。 ドキュメントに従って、AppDelegateに追加します。 キーを設定した後にのみ、YMKMapViewを作成し、setupMap（）メソッドで必要な方法で構成できます。







ここで何が起こるか、後ほど適切な設定が必要になる過程で詳細に分析します



4）次は何ですか？そして、CLLocationの初期位置がありましたが、それを使用するには、CoreLocationフレームワークを手動で追加するか、または...またはYandex mapkitのYMKPointで置き換える必要があります







5）さらに、マップはこの座標を中心に非常に簡単な方法で配置されましたが、現在は単純な方法はありません







しかし、もう少し複雑で少し深いマップオブジェクトがあります）... mapView.mapWindow.map！.Move。 ここでは、YMKCameraPositionなどのオブジェクトの存在について学習します。







6）次に、そのようなapi /プロパティがないため、マップ構成にコメントします。 少なくとも最小限に開始するために、ここでは省略します。



注釈の追加についてコメントします（これは標準の機能であることに注意します）。また、最も近いポイントの表示についてもコメントします（これは既に何らかの機能です）。



また、YMKMapViewDelegate全体も解説です。これは、新しいフレームワークでは見つけられませんでしたが、同様の類似物でもあります。







実装は省略し、メソッド自体のみを省略しました。



-ユーザーの位置を表示するかどうか、

-ピンに使用するビュー、

-注釈をクリックしたときの反応、

-注釈のコールアウト、

-コールアウトをクリックしたときの反応、つまり、通常使用するすべて。 結局、ある種のAPIカードを使用する何らかの方法がありました。



すべてがMapVCで計算されました-これは、マップキットが使用されたメインクラスです



7）カスタムコールアウトに関する少しのコメント。YMKCalloutViewを継承しません。新しいクジラにはもうありません。



ほら、プロジェクトが集まったので、私はすべてを始めて...箱の中のノートブックを見ることができました。開始後、あなたは「ウォームアップ」する時間を与える必要があるため）））しかし、私はそれについて知らず、何かがそうではないと思ったそのため、キーをアクティブにするのに時間がかかることを提案しましたが。 仮定が正しいことが判明しました。 約1時間待つ必要があります（多分何かが変わったのかもしれません）。



古いAPIを新しい方法で変更しようとすると、マップが表示されました。

ステージ2-「検索」（古い方法を新しい方法で実装する方法）

失われた機能の復元を始めましょう。 そのため、ユーザーロックを表示する必要がありますが、以前の方法ではプロパティを変更してデリゲートを設定するだけではできません。



これはレイヤーを介して行われます。setupMap（）メソッドポイント3を参照してください。







デモの例（ Yandex githubからダウンロード ）があるので、見てみましょう 。 ところで、setAnchorWithに注意する必要があります。 後で説明しますが、ズームに関連しています。 わかりました場所は動作します。



2）次はもちろん、注釈です。 古い方法で追加することはできません。もう一度デモをご覧ください。 そこにクラスがあります-MapObjectsViewController。 新しいバージョンでは、ピンをマップに追加するためにデリゲートは必要ありません。そのため、mapObjectsプロパティにアクセスし、オブジェクトでaddPlacemarkメソッドを呼び出し、そこに座標を渡す必要があります（まだ他のオーバーロードがあります）例：







アノテーションのコレクションを反復処理し（たとえば、サーバーから受信した後）、マップに追加します。 ちなみに、このメソッドは「placeMark」（プレースラベル）を返します。これは、たとえばzIndexプロパティを使用して表示順序を変更するなど、追加の設定を行うために使用できます。



しかし、ここで、私は前に登って代理人を探して、彼を安全に見つけることができず、単一の代理人ではなかったという点を逃しました（実際、彼らは単に別の名前で呼ばれ始めました、今では彼らはリスナーです）。 Appleクジラと古いYandexクジラの以前の経験から、セルと同様に注釈が再利用されることを知っていますが、デモにはaddPlacemarkしかありません。 Yandex-cardsのリードについての質問（小さな個人的な知り合いが助けた）「-メモリ使用量を最適化する方法、オブジェクトを再利用する方法？」



注：1）Yandex.Mapsはマップキットを使用し、開発しないことに注意することが重要です。 これは、マップキットチームによって行われます（ハブのニコライのニックネーム-likhogrud @）。



2）オブジェクトが再利用されない理由の説明：



古いクジラでは、annotationViewsはビューであり、ユーザーによって作成されました。もちろん、作成は安価ではないため、ビューを再利用する必要があります。 新しいクジラでは、オープンGLで直接マップキットによって目印が作成されます。 そして、そこで再利用されるかもしれませんが、これは不正確です。 いずれにせよ、これはビューを作成するよりもはるかに効率的です。



3）新しいものから、ところで、ユーザーの注釈アイコンを変更する可能性があります。 次のように実装します。リスナー（デリゲートのアナログ）を追加し、適切なプロトコルを実装する必要があります-3つのメソッドのうち1つ、2つだけを空のままにします。



同時に、目印をアイコンで再読み込みします。







また、アンカーのプロパティに注目します。 地図上のユーザーの位置ボタンをクリックすると、カメラは位置の中心にフォーカスを移動します。 しかし、問題は、もう一度アクションを押しても生成されないことです。 なに？ アンカーメソッドについてコメントすると、すべてが機能します。



4）クリックを解決するために、それぞれコールアウトを表示する必要があります。 インターフェースにはいくつかのメソッドがありますが、正しいメソッドはYMKMapObjectTapListenerです。 後で自分自身を苦しめなければならなかった重要な興味深い方法が1つあります。サブスクライバが見つかった場合にさらに統合しないようにtrueを返します。 私はあなたの注意を引きます、あなたは最初にサブスクライブする必要があります、mapObjectsはサブスクライブされます（149行目）。











したがって、クリックは満たされます。 やったー それでも、可視ゾーンにのみピンを表示する試みがありましたが、これは不要であり、一度にすべてを表示するため、そのままにしておきます（スローダウンしないため）



5）それから、私は便利のためにボタンを拡大/縮小させたかった。 場所ボタンとの類推による小さなコピーアンドペーストと編集、そして完了です。



さらに、カメラについて知っているので、必要に応じてmoveメソッドを使用し、それに応じて現在のズーム+-1または0.5を使用します。 ここですべてが順調です。







6）主な機能-コールアウト（これは追加情報のある長方形で、下部に三角形があります）を参照します。 APIがないことがわかりました（「夏には酔わせる」-この記事を手動で入力しないように、リーフレットからメモを読んだときにYandexが私のスピーチを認識しました）。







元気ですか？ 100 500アプリケーションはコールアウトを使用します。



私たちは、「テクニカルサポート」（Kolya）でこれを手動で行う方法をよく書いています。 あなたのオプションは何ですか？



ビューを画像に変換します （3.1でファイルを追加した）ビューを直接追加することはできないため、アイコンを変更します...







これらの松葉杖は平地で手に入れられたようです。

実際、松葉杖ではなく、もちろん、基本的な機能を考慮するだけで不在です。



7）さて、最初にテストコールアウトを追加しましょう。赤い正方形を使用します。 そのため、ピンをクリックすると、デリゲート/リスナーメソッドが呼び出され、クリックポイントとオブジェクトが渡されます。 トリックを期待することなく、コールアウトを追加するポイントとして「ポイント」を使用します。 （注意、すべてが正しく行われました：「彼らはクリックし、ポイントを取って、それを縛りましたか？」約80％が正しく答え、20％はそうではありませんでした）







そして、メソッド本体でshowCalloutヘルパーメソッドを呼び出します。







544行目

内部で、赤色のテストビューを40 x 40で作成し、それを画像に変換し、値0.5の定数xを宣言します。これは、ポイントの中央にコールアウト三角形を配置するために使用されます。 彼は自分の位置を変えるという考えを拒否し、後でカメラを動かして、選択されたコールアウトが電話スクリーンの中央に表示されるようにした



次に、tappableAreaの「プッシュ」エリアを宣言します。ピンのアイコンスタイルにはこのようなプロパティがあります。 まあ、クリックゾーンを制限することができます、それを行います。 ゾーンの範囲は0.0〜1.1です。 下の部分が必要です。ここには、以前に画像に変換されたボタンがあると思われます（覚えておいてください）。 さて、ボタンが下にあるため、これはゾーン（0,0.5-1.1）を意味します。

ゾーン制限は機能しますが、ニュアンスがあり、すべてを無効にします。 押されていない領域の下に別のピンがある場合、押すと機能します。 このエリアの意味は？ クリックが通過しないように、フラグなどを作成しますか。 さて...



550ライン

アイコンのスタイルを作成すると、最初のパラメーターでアンカーの位置をすぐに指定できます。たとえば、下の557行目でした。 位置yは1.05に等しく、三角形をピンの上に再び垂直に上げます



559ライン

特定のサイズのカスタムコールアウトを作成し、

選択した注釈selectedAnnotationからの情報、特にタイトルとサブタイトル、このコールアウトのボタンの碑文を使用して、必要なフィールドを構成します。 その後、あなた自身があなたがやりたいことができます。 選択した注釈は、デリゲートで以前に定義されています。 しかし、今のところは、以前に作成した赤い正方形を追加します

次に、ピンをmapObjectsコレクションに追加します。メソッドは追加された目印を返し、変数に保存します。

コールアウト自体をクリックすると、詳細なコントローラーが開くため、ポップアップの下に別のピンが入力され、デリゲートがそれに入ると、デリゲートが再び機能するため、ここでzIndexを使用して階層内の順序を変更する必要があります。 可視性を設定し、コールアウトを564行目の中央に移動します



ニュアンス ：変数目印は、コールアウトへのポインターです。

最初はピンがありません。ピンをクリックすると表示されます。次のピンをクリックした後、最初のコールアウトを削除して新しいコールアウトを追加する必要があります。 したがって、変数placemark！= Nilの場合、mapObjectsコレクションから古いコールアウトを削除する必要があります）







また、カードのタパスの場合、コールアウトを非表示にする必要があるため、デリゲートメソッドで目印を割り当て、オブザーバーが機能し、コールアウトが削除され、選択した注釈がクリアされます



このため、以前にYMKMapInputListenerにサインアップしました







次に、ビューを変換する方法は次のとおりです。 （バージョン3.1では、マップにビューを追加する機能が追加されました）

ビューの実行方法については説明しません）が、これに多くの問題（可能性のある三角形）がある場合は、このステージを追加します。







下の三角形の下にある場所には、高さに追加された魔法20が必要です。



また、特定の場所（左、右、中央）のピンにポップアップをポップアップ（アタッチ）する必要があります。これには、アンカープロパティがあります。 次のように定義されます：

マップの可視領域を3つの垂直ゾーンに分割し、どのゾーンにいるかを判断し、それに応じてバインディングの位置を変更します。 コード例では、左側にあるかどうかを確認します。同様に、中央にある場合、左側にない場合と中央にない場合、右側のポイントは







ポイントが領域に該当するかどうかを確認するヘルパー関数：







スタート。 動作します。 しかし、微妙な違いがあります。ズームしようとしているようです。1、2、3、そしてコールアウトはピンから飛び出します。 なに？ どうやって？







7）デバッグを開始します。座標は同じです







その後、何が起こっているのか、どのように機能するのかを理解しようと試み、デモに戻り、さらに注意深い違いの検索を行いました...







私は、座標が直接送信され、tapuのものではないことに気付きました！ しかし、結局のところ、私は、座標が同じであること、つまり、円と正方形の座標が同じであることは明らかです。

そのため、メソッドではオブジェクトにすぐにアクセスせず、ポイントを渡しましたが、これは正しくありません。







しかし、オブジェクトをキャストし、プロパティを取得する必要があります（すべてが異なる方法で呼び出されるすべての場所で、ここで現在のジオメトリを調整してからポイントする）は、この種のクリエイティブなのですか？ 493行







同じピンを繰り返しクリックした場合、最初のピン留め、2番目のコールアウト、およびクリックを処理しないという2つの押すオプションを処理する必要があるため、 最初に行うことは、ピンコレクションでクリックしたピンを見つけることです495行を調整します。それ以外の場合はtrueを返します。これにより、クリックを処理し、階層をさらに進める必要がないと言います。



次に 、ピンまたはコールアウトをクリックして、499行ラベルの座標を比較します。 同等性テスト：







さらに、これがコールアウトであり、領域全体ではなくボタンクリックに応答する（または、現在は画像であるために模倣する）場合は、ペンでいくつかの計算を行う必要があります:)

1. 世界座標を画面501行に変換する
   
   私たちは自分自身を考慮します：マップ座標を画面上に変換し、現在位置を確認し、ビューの幅と高さを追加することでコーナーポイントを取得しますが、何らかの理由でそれらが一致せず、手動で3倍します（私の場合は10番目のiPhone））。 後で判明したように、私は忘れており、ポイントあたりのピクセル数を考慮しませんでした。 1x（1ポイント1ピクセル）、2x、3x 1ポイントは3ピクセルです。
2. ボタンの高さ-コールアウトの高さ+三角形の高さ、スケール、スケールに関する情報（行498）を計算します。 次に、ボタンの高さがコールアウトの高さの半分であるため、これをすべて2つに分割します。
3. 次に、アンカー（x：0.5、y：1）に基づいて、角度の座標を計算します。三角形のスケールと面積が与えられます））
4. 次に、これらの画面座標を世界に変換します
5. それらに基づいて表示領域を作成します。ボタンゾーンです
6. そして、ボタンゾーンにヒットしたかどうかを確認します。 ヒットしたら、注釈のタイプを確認し、タイプに応じて、いくつかのメソッドを呼び出します。詳細画面に移動するか、StorePointを使用する場合の配信用にこのストアを選択します

それ以外の場合は、ピンをクリックするだけで、実際に上記で行ったコールアウトを追加する必要があります。



以上で、新しいクジラとの最初の知り合いは終わりました。



他に言いたいのは、現在のmappitマップの実装には使用されていない多くの機能が含まれていることです。これは、結果のバイナリのサイズにも影響します。 あなたはそのような犠牲の準備ができていますか、将来的に、みんなは結局モジュールに取り壊されるべきです。 また、ワークショップのアンドロイドの同僚から、Kotlinとの互換性に問題があると聞きました。



追伸 私が記事を書き始めたとき、上記の問題が解決され実装されたアップデート3.1が発表されました。



追加しました



Androidの場合、arm64およびx86ビルドが登場しました。

任意のViewオブジェクトをマップに追加できます。

自転車ルーティングが登場しました。

Androidにnullableアノテーションを追加しました。



変更された



MapKitはいくつかの部分に分かれています。

MapKit-マップのみ。

MapKitルート-車のルーティング;

MapKit Transport-歩行者ルート、公共交通ルート、自転車ルート。

MapKit Search-検索とジオコーディング。

MapKit Places-パノラマ。

iOSの場合、null可能注釈はより厳格になりました。



修正済み



多くのバグが修正されました。

パフォーマンスの改善。



tech.yandex.ru/maps/doc/mapkit/3.x/concepts/versions-docpage



コメント、質問を書いてください。