Utiliser votre propre moteur de rendu de tuiles 3D

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

URL de contenu

Lorsque vous diffusez des tuiles 3D photoréalistes, l'API Map Tiles renvoie les URI des jeux de tuiles enfants. Ces URI de jeux de tuiles ne sont pas des URL standards. Ils n'incluent que le composant de chemin d'accès et de paramètres. Ils ne contiennent pas votre clé API, qui est nécessaire pour autoriser votre requête. Pour en savoir plus, consultez les spécifications des tuiles 3D.

Requêtes et réponses

Voici quelques exemples de requêtes et de réponses 3D Tiles photoréalistes. Vous les inspectez à 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 jeu de vignettes:

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

Exemples d'URL de requête 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 associer tous les paramètres qui apparaissent dans l'URI du jeu de tuiles avec 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é pour 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 l'associer à toutes les requêtes de tuiles ultérieures.

Afficher les attributions

L'attribution signifie que vous devez connaître la source des tuiles de carte. Elle est indispensable pour utiliser cette API, y compris l'attribution de la marque Google (logo) ainsi que l'attribution des données. Le logo Google est disponible sur la page Règles de l'API Map Tiles. Des informations d'attribution de données sont renvoyées dans chaque réponse de carte. Recherchez-le dans le corps de la réponse, dans le fichier JSON sous asset.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 de l'affichage. Cela implique les étapes suivantes:

  1. Extrayez toutes les informations sur les droits d'auteur de toutes les tuiles 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, dans l'ordre décroissant, de la même manière que dans Google Earth.