Protocollo riquadro semantico e server di esempio

L'interfaccia del buffer di protocollo in semantictileapi.proto viene utilizzata dall'SDK Unity per recuperare risorse dei riquadri delle caratteristiche e del terreno. Questa API deve essere implementata da un servizio sostitutivo. È incluso un server Python di esempio per dimostrare in che modo i parametri vengono trasmessi dall'SDK e come deve essere formulata la risposta per garantire la compatibilità con l'SDK.

Scarica l'archivio

L'archivio contiene i seguenti file:

  • semantictileapi.proto è una definizione di buffer di protocollo utilizzata dall'SDK Unity per recuperare risorse delle funzionalità e dei riquadri del terreno.

  • server.py è un server di esempio che dimostra la serializzazione e la gestione del buffer di protocollo compatibili con l'SDK.

  • BUILD.bazel e WORKSPACE.bazel insieme formano un progetto Bazel che puoi usare per generare le associazioni del buffer di protocollo per Python. Visita https://bazel.build/ per ulteriori informazioni su come installare e utilizzare Bazel.

  • example_tiles.py mostra alcuni esempi di come creare FeatureTiles e TerrainTiles utilizzando Python.

Come eseguire

Dopo aver installato Bazel, puoi semplicemente eseguire il comando seguente per creare e avviare il server:

> bazel run server

Se non vuoi installare Bazel, puoi anche creare la libreria del buffer di protocollo Python utilizzando Protoc. Consulta Informazioni di base sul buffer del protocollo: Python per informazioni su come utilizzare lo strumento Protoc, anche se consigliamo di utilizzare Bazel per creare questo esempio.

Puoi inviare una richiesta al server in esecuzione con cURL:

> curl 'localhost:8000/featuretiles/@120588,78656,17z?alt=proto' --output test_feature
> curl 'localhost:8000/terraintiles/@120588,78656,17z?alt=proto' --output test_terrain

Per visualizzare un formato leggibile, utilizza alt=json

> curl 'localhost:8000/featuretiles/@120588,78656,17z?alt=json'

Ulteriori informazioni sui formati dei riquadri delle funzionalità e del terreno sono disponibili nei commenti di semantictileapi.proto.