Mit dem eigenen 3D-Kachel-Renderer arbeiten

Entwickler im Europäischen Wirtschaftsraum (EWR)

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

Inhalts-URLs

Beim Bereitstellen von fotorealistischen 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 den Pfad und die Parameterkomponente. Sie enthalten nicht Ihren API-Schlüssel, der zur Autorisierung Ihrer Anfrage erforderlich ist. Weitere Informationen finden Sie in der 3D Tiles-Spezifikation.

Anfragen und Antworten

Hier sind einige Beispiele für Anfragen und Antworten für fotorealistische 3D-Kacheln. Sie können sie mit den Chrome-Entwicklertools untersuchen.

Beispielanfrage für ein Root-Tileset:

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

Beispiel-URI für Kachelsatzantwort:

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

Beispiel-URLs für Kachelanfragen, 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 alle Parameter, die im Tileset-URI enthalten sind, zusammen mit Ihrem API-Schlüssel anfügen, wenn Sie die nachfolgenden Kachelanfragen erstellen. Die 3D Tiles API bietet die folgenden zwei 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, den Sie für den Zugriff auf den 3D Tiles-Dienst verwendet haben. Sie müssen sie an alle nachfolgenden Kachelanfragen anhängen.

Quellenangaben anzeigen

Die Quellenangabe ist eine Voraussetzung für die Verwendung dieser API. Sie umfasst die Quellenangabe für die Marke Google (Logo) sowie die Datenquellenangabe. Das Google-Logo ist auf der Seite Richtlinien für die Map Tiles API verfügbar. Informationen zur Datenzuordnung werden in jeder Kachelantwort zurückgegeben. Sie finden sie auf der glTF-Kachel 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. Extrahieren Sie alle Copyright-Informationen aus allen sichtbaren Kacheln.

  2. Trennen Sie mehrere Quellenangaben durch ein Semikolon.

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

  4. Die Urheberrechtsquellen sollten auf dem Bildschirm angezeigt werden, sortiert nach der Häufigkeit des Vorkommens, ähnlich wie in Google Earth.