Mit dem eigenen 3D-Kachel-Renderer arbeiten

Wenn Sie kein Rendering-Produkt 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 die folgenden wichtigen Faktoren berücksichtigt werden:

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 Komponente „Pfad“ und „Parameter“. Sie enthalten nicht Ihren API-Schlüssel, der zur Autorisierung 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 Stammkachelsatzanfrage:

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

Beispiel für einen Kachelsatz-Antwort-URI:

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

Beispiele für Kachelanfrage-URLs, die von Renderern verwendet werden:

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

Sie sollten beim Erstellen der nachfolgenden Kachelanfragen alle Parameter, die im Kachelsatz-URI enthalten sind, zusammen mit Ihrem API-Schlüssel anhängen. Die 3D Tiles API bietet die folgenden beiden Parameter:

session
Eine integrierte Kennung für eine 3D-Ladesitzung. Sie 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-Kachel-Dienst zugegriffen haben. Sie müssen ihn an alle nachfolgenden Kachelanfragen anhängen.

Quellenangaben für das Displaynetzwerk

„Attribution“ bedeutet, dass die Quelle der Kartenkacheln erkannt wird. Dies ist eine Voraussetzung für die Verwendung dieser API – dies umfasst die Google-Markenattribution (Logo) und die Datenattribution. Das Google-Logo steht Ihnen auf der Seite mit den Map Tiles API-Richtlinien zur Verfügung. Informationen zur Datenattribution werden in jeder Kachelantwort zurückgegeben. Sie finden es 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"
  }
}

Sie müssen diese Informationen in einer Textzeile zusammenfassen, sortieren und anzeigen, in der Regel unten im Rendering. Dazu sind folgende Schritte erforderlich:

  1. Extrahiert alle Urheberrechtsinformationen aus allen angezeigten Kacheln.

  2. Trennen Sie mehrere Urheberrechtsquellen durch ein Semikolon.

  3. Sortieren Sie die Informationen nach der Anzahl der Vorkommen.

  4. Die Urheberrechtsquellen werden auf dem Bildschirm angezeigt, ähnlich wie in Google Earth, und zwar von den meisten Vorkommen bis nach unten.