Mit dem eigenen 3D-Kachel-Renderer arbeiten

Wenn Sie kein Renderingprodukt eines Drittanbieters in Ihre Lösung einbinden können, müssen Sie möglicherweise einen eigenen 3D-Kachel-Renderer erstellen. Bei diesem Ansatz müssen Sie die folgenden wichtigen Faktoren berücksichtigen:

Content-URLs

Beim Bereitstellen fotorealistischer 3D-Kacheln gibt die Map Tiles API URIs für untergeordnete Kachelsätze zurück. Diese Kachelsatz-URIs sind keine regulären URLs. Sie enthalten nur die Pfad- und Parameterkomponente. Sie enthalten nicht Ihren API-Schlüssel, der zum Autorisieren Ihrer Anfrage erforderlich ist. Weitere Informationen finden Sie in der Spezifikation für 3D-Kacheln.

Anfragen und Antworten

Hier sind einige Beispiele für Anfragen und Antworten zu fotorealistischen 3D-Kacheln. Sie können sie mithilfe der Chrome-Entwicklertools überprüfen.

Beispiel für eine Root-Kachelsatzanfrage:

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

Beispiel für einen Antwort-URI für den Kachelsatz:

 /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg

Beispiele für von Renderern verwendete Kachelanforderungs-URLs:

https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY
https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYubm9k.glb?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY

Wenn Sie die nachfolgenden Kachelanfragen erstellen, sollten Sie alle im Kachelsatz-URI enthaltenen Parameter zusammen mit Ihrem API-Schlüssel anhängen. Die 3D Tiles API bietet die folgenden zwei Parameter:

session
Eine integrierte Kennung für eine 3D-Ladesitzung. Er wird automatisch von der API generiert. Sie muss vom Renderer angehängt werden, wenn die nachfolgenden Kachelanfragen erstellt werden.
key
Der API-Schlüssel, mit dem Sie auf den 3D-Kacheldienst zugegriffen haben. Sie müssen ihn an alle nachfolgenden Kachelanfragen anhängen.

Quellenangaben für das Displaynetzwerk

Bei der Attribution muss die Quelle der Kartenkacheln anerkannt werden. Sie ist eine Voraussetzung für die Verwendung dieser API. Dazu gehören die Markenkennzeichnung (Logo) und die Datenzuordnung von Google. Das Google-Logo finden Sie auf der Seite mit den Map Tiles API-Richtlinien. In jeder Tile-Antwort werden Informationen zur Datenattribution zurückgegeben. Sie finden sie im Antworttext in der JSON-Datei unter asset.copyright.

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

Diese Informationen müssen in einer Textzeile zusammengefasst, sortiert und angezeigt werden, normalerweise unten im Rendering. Dazu sind folgende Schritte erforderlich:

  1. Extrahieren Sie alle Urheberrechtsinformationen aus allen angezeigten Kacheln.

  2. Trenne mehrere Urheberrechtsquellen durch ein Semikolon voneinander.

  3. Die Informationen werden basierend auf der Anzahl der Vorkommnisse sortiert.

  4. Hiermit werden die Urheberrechtsquellen auf dem Bildschirm, ähnlich wie in Google Earth, in absteigender Reihenfolge angezeigt.