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.
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
eWORKSPACE.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 creareFeatureTiles
eTerrainTiles
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
.