Utiliser votre propre moteur de rendu de tuiles 3D

Si vous ne parvenez pas à intégrer un produit de rendu tiers à votre solution, vous devrez peut-être créer votre propre moteur de rendu pour les cartes 3D. Cette approche nécessite de prendre en compte les facteurs importants suivants :

URL de contenu

Lors de la diffusion de tuiles 3D photoréalistes, l'API Map Tiles renvoie des URI pour les ensembles de tuiles enfants. Ces URI d'ensemble de tuiles ne sont pas des URL normales. Ils incluent uniquement le composant "Path and parameters" (chemin d'accès et paramètres). Elles ne contiennent pas votre clé API, qui est requise pour autoriser votre requête. Pour en savoir plus, consultez la spécification des cartes 3D.

Requêtes et réponses

Voici quelques exemples de requêtes et de réponses pour les tuiles 3D photoréalistes. Toi les inspecter à l'aide des outils pour les développeurs Chrome.

Exemple de requête de jeu de tuiles racine :

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

Exemple d'URI de réponse de la carte de tuiles :

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

Exemples d'URL de requêtes de tuiles utilisées par les moteurs de rendu:

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

Vous devez joindre tous les paramètres qui apparaissent dans l'URI du jeu de tuiles, ainsi que votre clé API, lorsque vous créez les requêtes de tuiles suivantes. L'API 3D Tiles fournit les deux paramètres suivants :

session
Identifiant intégré d'une session de chargement 3D. Il est généré automatiquement par l'API. Il doit être associé par le moteur de rendu lors de la création des requêtes de tuiles ultérieures.
key
Clé API que vous avez utilisée pour accéder au service 3D Tiles. Vous devez le joindre à toutes les requêtes de carte ultérieures.

Attributions display

L'attribution consiste à reconnaître la source des tuiles de carte et est obligatoire pour l'utilisation de cette API. Cela inclut l'attribution de la marque (logo) de Google, ainsi que l'attribution des données. Vous pouvez utiliser le logo Google sur le Page Règles de l'API Map Tiles. Les informations d'attribution des données sont renvoyées dans chaque réponse de carte. Recherchez-le dans la vignette glTF, sous asset et copyright.

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

Vous devez agréger, trier et afficher ces informations sur une ligne de texte, généralement en bas du rendu. Pour ce faire, procédez comme suit :

  1. Extrayez toutes les informations sur les droits d'auteur de toutes les cartes visibles.

  2. Séparez les différentes sources de droits d'auteur par un point-virgule.

  3. Triez les informations en fonction du nombre d'occurrences.

  4. Affichez les sources des droits d'auteur à l'écran, classées du plus grand nombre de la même manière que Google Earth le fait.