Interfejs bufora protokołu w semantictileapi.proto jest używany przez pakiet SDK Unity do pobierania zasobów kafelków i obiektów. Usługa zastępcza powinna wdrożyć ten interfejs API. Dołączono przykładowy serwer Pythona, aby pokazać, jak pakiet SDK przekazuje parametry i jak powinna wyglądać odpowiedź na żądanie.
Archiwum zawiera te pliki:
semantictileapi.prototo definicja bufora protokołu używana przez pakiet SDK Unity do pobierania zasobów kafelków funkcji i terenu.server.pyto przykładowy serwer, który demonstruje serializację i wyświetlanie buforów protokołów i jest zgodny z pakietem SDK.Razem
BUILD.bazeliWORKSPACE.bazeltworzą projekt Bazel, którego można użyć do wygenerowania powiązań buforów protokołu dla języka Python. Więcej informacji o instalowaniu i używaniu usługi Bazel znajdziesz na stronie https://bazel.build/.example_tiles.pypokazuje kilka przykładów tworzenia obiektówFeatureTilesiTerrainTilesprzy użyciu języka Python.
Jak uruchomić
Po zainstalowaniu bazy danych możesz uruchomić następujące polecenie, aby skompilować i uruchomić serwer:
> bazel run server
Jeśli nie chcesz instalować Bazelu, możesz też utworzyć bibliotekę bufora języka Python za pomocą Protoc. Informacje na temat korzystania z narzędzia protoc znajdziesz w artykule Protocol Buffer Basics: Python. Do tworzenia tego przykładu zalecamy użycie bazy danych Bazel.
Możesz wysłać żądanie do działającego serwera za pomocą narzędzia 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
Jeśli chcesz wyświetlić format w postaci zrozumiałej dla człowieka, użyj formatu alt=json
> curl 'localhost:8000/featuretiles/@120588,78656,17z?alt=json'
Więcej informacji na temat formatów funkcji i kafelków terenu znajdziesz w komentarzach semantictileapi.proto.