Tworzenie zbioru danych i zarządzanie nim

Ta usługa lub funkcja jest w wersji przedpremierowej. Usługi i funkcje przed GA mogą mieć ograniczoną obsługę, a zmiany w takich usługach mogą być niezgodne z ich innymi wersjami. Oferty przed GA są objęte szczegółowymi warunkami korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania.

Zbiory danych umożliwiają przesyłanie danych geoprzestrzennych z pliku lokalnego lub z Google Cloud Storage do Google Maps Platform. Potem możesz powiązać zbiór danych z 1 lub większą liczbą stylów mapy w konsoli Cloud. Po powiązaniu zbioru danych ze stylem map możesz użyć interfejsu API stylu opartego na danych, aby dynamicznie ustalać styl swojej aplikacji z mapami.

Możesz też przesłać dane geoprzestrzenne do zbioru danych za pomocą interfejsu API REST. Więcej informacji znajdziesz na stronie interfejsu API Datasets API.

Skonfiguruj role

Aby tworzyć zbiory danych w projekcie Google Cloud i nimi zarządzać, musisz mieć w tym projekcie rolę Właściciel lub Edytujący.

Uwaga: jeśli projekt został utworzony przez Ciebie, masz w nim rolę właściciela. Na stronie Uprawnienia w konsoli Google Cloud znajdują się właściciele i edytujący projekt.

Możesz też przypisać poniższe role uprawnień do konta użytkownika lub konta usługi, którego używasz do zarządzania zbiorami danych:

• Rola Maps Platform Datasets Admin przyznaje kontu użytkownika lub konta usług uprawnienia do zapisu i odczytu zbiorów danych w projekcie. Ta rola umożliwia użytkownikowi wykonywanie wszystkich operacji na zbiorze danych.
• Rola Maps Platform Datasets Viewer zapewnia dostęp tylko do odczytu do zbiorów danych w projekcie. Ta rola umożliwia wykonywanie operacji na liście, pobieraniu i pobieraniu na zbiorze danych.

Więcej informacji znajdziesz w artykule o przyznawaniu roli uprawnień za pomocą konsoli Google Cloud.

Źródło danych dla zbioru danych

Gdy utworzysz zbiór danych, prześlij do niego dane z Google Cloud Storage lub z pliku lokalnego.

Uwaga: dane do zbioru danych możesz przesłać tylko raz. Oznacza to, że po uruchomieniu żądania przesłania danych z Cloud Storage lub z pliku lokalnego nie możesz ponownie przesłać danych do tego samego zbioru danych. Jeśli podczas przesyłania wystąpi błąd, musisz ponownie utworzyć zbiór danych i spróbować jeszcze raz.

• Podczas przesyłania danych z Cloud Storage podaj ścieżkę pliku do zasobu zawierającego dane w Cloud Storage. Ma ona format gs://GCS_BUCKET/FILE.

  Użytkownik przesyłający żądanie wymaga roli Wyświetlający obiekty Cloud Storage lub dowolnej innej roli zawierającej uprawnienie storage.objects.get. Więcej informacji o zarządzaniu dostępem do Cloud Storage znajdziesz w omówieniu kontroli dostępu.

• Podczas przesyłania danych z pliku lokalnego podaj ścieżkę do pliku GeoJSON, KML lub CSV zawierającego dane do przesłania.

Wymagania wstępne

Podczas tworzenia zbioru danych:

• Wyświetlane nazwy muszą być unikalne w obrębie projektu Google Cloud.
• Wyświetlane nazwy muszą mieć mniej niż 64 bajty (ponieważ te znaki są reprezentowane w formacie UTF-8, dlatego w niektórych językach każdy znak może być reprezentowany przez wiele bajtów).
• Opisy muszą być mniejsze niż 1000 bajtów.

Podczas przesyłania danych:

• Obsługiwane typy plików to CSV, GeoJSON i KML.
• Maksymalny obsługiwany rozmiar pliku to 350 MB.
• Nazwy kolumn atrybutów nie mogą zaczynać się od „?_”.
• Trójwymiarowe geometrie nie są obsługiwane. Obejmuje to sufiks „Z” w formacie WKT i współrzędne wysokości w formacie GeoJSON.

Uwaga: w zależności od rozmiaru pliku danych przesyłanie może potrwać kilka minut lub nawet godzin. Jeśli podczas przesyłania wystąpi błąd, pojawi się komunikat o błędzie. Nie próbuj usuwać zbioru danych, dopóki nie zwróci on odpowiedzi z operacji przesyłania.

Wskazówka: jeśli plik danych jest duży i zawiera wiele atrybutów, których nie potrzebujesz do określania stylu, a chcesz zoptymalizować wydajność renderowania, edytuj plik, aby usunąć niepotrzebne atrybuty. Zmniejszenie liczby atrybutów zmniejsza rozmiar kafelków mapy, a tym samym poprawia wydajność renderowania.

Wymagania GeoJSON

Maps JavaScript API obsługuje bieżącą specyfikację GeoJSON. Interfejs Maps JavaScript API obsługuje też pliki GeoJSON, które zawierają dowolny z tych typów obiektów:

• Obiekty geometryczne. Obiekt geometryczny to kształt przestrzenny określany jako połączenie punktów, linii i wielokątów z opcjonalnymi otworami.
• Obiekty funkcji. Obiekt funkcji zawiera geometrię i dodatkowe pary nazwa/wartość, których znaczenie jest charakterystyczne dla aplikacji.
• Kolekcje funkcji. Kolekcja cech to zbiór obiektów cech.

Maps JavaScript API nie obsługuje plików GeoJSON, które zawierają dane w układzie współrzędnych (CRS) innym niż WGS84.

Więcej informacji o GeoJSON znajdziesz w artykule Zgodność z RFC 7946.

Wymagania dotyczące plików KML

Interfejs Maps JavaScript API ma następujące wymagania:

• Wszystkie adresy URL muszą być lokalne (lub względne) w stosunku do samego pliku.
• Geometria punktów, linii i wielokątów jest obsługiwana.
• Wszystkie atrybuty danych są traktowane jako ciągi znaków.

Te funkcje KML nie są obsługiwane:

• Ikony lub <styleUrl> zdefiniowane poza plikiem.
• Linki sieciowe, takie jak <NetworkLink>
• Nakładki na powierzchni, np. <GroundOverlay>
• Geometrie 3D lub wszelkie tagi związane z wysokością, np. <altitudeMode>
• Specyfikacje aparatu, takie jak <LookAt>
• Style zdefiniowane w pliku KML.

Wymagania dotyczące pliku CSV

W przypadku plików CSV obsługiwane nazwy kolumn są wymienione poniżej w kolejności według priorytetu:

• latitude, longitude
• lat, long
• x, y
• wkt (Znany tekst)
• address, city, state, zip
• address
• jedna kolumna zawierająca wszystkie informacje adresowe, np. 1600 Amphitheatre Parkway Mountain View, CA 94043

Twój plik zawiera np. kolumny o nazwach x, y i wkt. Ponieważ x i y mają wyższy priorytet (zgodnie z kolejnością obsługiwanych nazw kolumn z listy powyżej), wartości w kolumnach x i y są używane, a kolumna wkt jest ignorowana.

Ponadto:

• Każda nazwa kolumny musi należeć do jednej kolumny. Oznacza to, że kolumna o nazwie xy nie może zawierać danych współrzędnych x i Y. Współrzędne x i y muszą znajdować się w osobnych kolumnach.
• W nazwach kolumn nie jest rozróżniana wielkość liter.
• Kolejność nazw kolumn nie ma znaczenia. Jeśli na przykład plik CSV zawiera kolumny lat i long, mogą one występować w dowolnej kolejności.

Obsługa błędów przesyłania danych

Podczas przesyłania danych do zbioru danych może wystąpić jeden z częstych błędów opisanych w tej sekcji.

Błędy GeoJSON

Typowe błędy GeoJSON:

• Brak pola type lub type nie jest ciągiem znaków. Przesłany plik danych GeoJSON musi zawierać pole ciągu znaków o nazwie type w każdej definicji obiektu Feature i Geometry.

Błędy KML

Typowe błędy w formacie KML to:

• Plik danych nie może zawierać żadnych nieobsługiwanych funkcji KML wymienionych powyżej. W przeciwnym razie import danych może się nie udać.

Błędy pliku CSV

Typowe błędy w pliku CSV:

• W niektórych wierszach brakuje wartości w kolumnie geometrii. Wszystkie wiersze w pliku CSV muszą zawierać niepuste wartości kolumn geometrycznych. Kolumny geometryczne:
  • latitude, longitude
  • lat, long
  • x, y
  • wkt
  • address, city, state, zip
  • address
  • jedna kolumna zawierająca wszystkie informacje adresowe, np. 1600 Amphitheatre Parkway Mountain View, CA 94043
  Uwaga: ten błąd jest często opisywany przez komunikat w formie „Nie udało się przekonwertować elementu ' ” na typ zmiennoprzecinkowy lub „Nie udało się przeanalizować danych wejściowych na potrzeby lokalizacji geograficznej.: Brak wartości geograficznej”.
• Jeśli kolumny geometryczne to x i y, sprawdź, czy podane jednostki to długość i szerokość geograficzna. Niektóre publiczne zbiory danych używają różnych układów współrzędnych pod nagłówkami x i y. Jeśli zostaną użyte nieprawidłowe jednostki, zbiór danych może zostać zaimportowany, ale wyrenderowane dane mogą wskazywać punkty zbioru danych w nieoczekiwanych lokalizacjach.

Utwórz zbiór danych

Aby utworzyć zbiór danych:

1. W konsoli Google Cloud otwórz stronę Zbiory danych.
2. Kliknij Utwórz zbiór danych.
3. Wpisz nazwę zbioru danych. Nazwa musi być unikalna wśród wszystkich zbiorów danych.
4. Opcjonalnie wpisz Opis zbioru danych.
5. Kliknij Dalej. Pojawi się strona Importowanie danych.
6. Wybierz źródło przesyłania danych używanych do wypełnienia zbioru danych jako komputer, czyli plik lokalny w Twoim systemie lub zasobnik Google Cloud Storage.
   • W przypadku komputera kliknij Przeglądaj, a następnie wybierz plik z selektora plików.
   • Obok opcji Zasobnik Google Cloud Storage kliknij Przeglądaj, a następnie wybierz zasobnik i plik zawierający dane.
7. Wybierz Format pliku.
8. Kliknij Dalej, aby sprawdzić ustawienia.
9. Kliknij Utwórz. Pojawi się strona Zbiory danych zawierająca nowy zbiór danych. Powinien on mieć stan Przetwarzanie.
10. Poczekaj, aż zbiór danych zmieni stan na Ukończono.

Wyświetlanie lub modyfikowanie zbioru danych

Gdy utworzysz zbiór danych, jego stan zmieni się na Ukończony. Możesz potem sprawdzić szczegóły zbioru danych.

Aby wyświetlić zbiór danych:

1. W konsoli Google Cloud otwórz stronę Zbiory danych.
2. Kliknij nazwę zbioru danych. Pojawi się strona Szczegóły zbioru danych.
   1. Kliknij kartę Szczegóły, aby wyświetlić informacje o zbiorze danych. Na tej karcie możesz też edytować nazwę i opis zbioru danych.
   2. Aby wyświetlić zbiór danych na mapie, kliknij kartę Podgląd.
   3. Kliknij kartę Dane w tabeli, aby wyświetlić podzbiór danych powiązanych ze zbiorem danych.
   4. Kliknij przycisk Pobierz, aby zapisać dane w pliku lokalnym.
   5. Kliknij przycisk Usuń, aby usunąć zbiór danych.