Tworzenie zbioru danych i zarządzanie nim

Wybierz platformę: Android iOS JavaScript

Zbiory danych umożliwiają przesyłanie danych geoprzestrzennych z pliku lokalnego lub z Google Cloud Storage do w ramach Google Maps Platform. Następnie możesz powiązać zbiór danych z co najmniej jednym stylem mapy w w konsoli Cloud. Po powiązaniu zbioru danych ze stylem map użyj metody interfejsu API stylu opartego na danych do dynamicznego określania stylu aplikacji z mapami.

Możesz także użyć interfejsu API typu REST, aby przesłać dane geoprzestrzenne do zbioru danych. Aby dowiedzieć się więcej, zobacz Maps Datasets API

Skonfiguruj role

Aby tworzyć zbiory danych w projekcie Google Cloud i nimi zarządzać, musisz mieć Rola uprawnień właściciela lub edytującego nad projektem.

Uwaga: jeśli projekt został utworzony przez Ciebie, masz rolę właściciela. nad projektem. Na stronie Uprawnienia konsoli Google Cloud wyświetla się właścicieli projektów i redaktorów.

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

• Rola Maps Platform Datasets Admin przypisuje konto użytkownika lub usługi 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 przyznaje dostęp tylko do odczytu do zbiorów danych w projekcie. Ta rola umożliwia wykonywanie list, pobieranie i pobieranie danych na zbiorze danych.

Więcej informacji: Przypisywanie roli uprawnień za pomocą konsoli Google Cloud

Źródło danych zbioru danych

Po utworzeniu zbioru danych prześlij do niego dane z: Google Cloud Storage lub z pliku lokalnego.

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

  Użytkownik wysyłający żądanie wymaga wyświetlającego obiekty Cloud Storage lub inną rolę, która obejmuje uprawnienie storage.objects.get. Dla: więcej informacji o zarządzaniu dostępem do Cloud Storage znajdziesz w artykule Omówienie kontroli dostępu

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

Wymagania wstępne

Podczas tworzenia zbioru danych:

• Wyświetlane nazwy muszą być unikalne w obrębie projektu Google Cloud.
• Wyświetlana nazwa musi mieć mniej niż 64 bajty (ponieważ znaki te są reprezentowane w formacie UTF-8, 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 500 MB.
• Nazwy kolumn atrybutów nie mogą zaczynać się od ciągu „?_”.
• Trójwymiarowe geometrie nie są obsługiwane. Obejmuje to litera „Z” w formacie WKT, i współrzędną wysokości w formacie GeoJSON.

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

Uwaga: fragmenty mapy utworzone z danymi przesłanymi za pomocą Interfejs Maps Datasets API może usuwać lub upraszczać gęste lub złożone dane przy małym powiększeniu. Na przykład, gdy plik użytkownik pomniejszy widok do stanu lub kraju (np. poziom powiększenia 5–12), a podzielone dane mogą wyglądać inaczej niż po powiększeniu miasta lub dzielnicy (np. poziom powiększenia 13–18). Dzieje się tak aby zadbać o smukłość i wydajność kart, korzystając z mechanizmu renderowania map.

Wskazówka: jeśli plik danych jest duży i zawiera wiele atrybutów których nie potrzebujesz do stylu, a jeśli chcesz zoptymalizować wydajność renderowania, edytuj pole i usuń niepotrzebne atrybuty. Zmniejszenie liczby zmniejszają rozmiar fragmentów mapy, co poprawia wydajność renderowania.

Sprawdzone metody przygotowywania danych

Jeśli dane źródłowe są złożone lub duże, na przykład gęste punkty, długie linie lub wielokąty (do tej kategorii należą często pliki źródłowe o rozmiarze przekraczającym 50 MB). Rozważ uproszczenie swoich danych. przed przesłaniem w celu osiągnięcia jak najlepszych wyników na mapie wizualnej.

Oto kilka sprawdzonych metod przygotowywania danych:

1. Minimalizuj właściwości cech. Zachowaj tylko właściwości cech niezbędne do określenia stylu mapę, na przykład „id”. i „category”. Możesz złączać dodatkowe usługi z cechą w kliencie. aplikacji korzystającej ze stylów opartych na danych na kluczu unikalnego identyfikatora. Na przykład zobacz Wyświetlanie danych w czasie rzeczywistym dzięki stylowi opartemu na danych
2. W miarę możliwości używaj prostych typów danych (takich jak liczby całkowite, liczby całkowite), aby zminimalizować rozmiar kafelków i poprawić wydajność mapy.
3. Przed przesłaniem pliku uprość złożone geometrie. Możesz to zrobić w wybranego przez siebie narzędzia geoprzestrzennego, takiego jak open source. Mapshaper.org lub BigQuery, ST_Simplify w obrębie złożonych geometrii.
4. Przed przesłaniem pliku grupuj bardzo gęste punkty. Możesz to zrobić w wybranego przez siebie narzędzia geoprzestrzennego, takiego jak open source. funkcjach klastra turf.js lub w BigQuery przy użyciu: ST_CLUSTERDBSCAN gęstej geometrii punktowej.

Dodatkowe wskazówki dotyczące sprawdzonych metod dotyczących zbiorów danych znajdziesz tutaj: Wizualizuj dane za pomocą zbiorów danych i BigQuery.

Wymagania GeoJSON

Maps SDK na Androida obsługuje aktualne Specyfikacja GeoJSON. Maps SDK na Androida obsługuje też pliki GeoJSON, które zawierają dowolny z tych typów obiektów:

• obiekty geometryczne – Obiekt geometryczny to kształt przestrzenny zdefiniowany jako suma punktów, linii i wielokątów z opcjonalnymi otworami.
• Obiekty funkcji. Obiekt cech obejmuje geometrię oraz dodatkowe pary nazwa/wartość, których znaczenie zależy od danej aplikacji.
• Kolekcje funkcji. Kolekcja cech to zbiór obiektów cech.

Maps SDK na Androida nie obsługuje plików GeoJSON, które zawierają dane w systemie odniesienia współrzędnych (CRS) innej niż WGS84.

Więcej informacji na temat GeoJSON znajdziesz na stronie Zgodność ze standardem RFC 7946.

Wymagania dotyczące formatu KML

Maps SDK na Androida ma następujące wymagania:

• Wszystkie adresy URL muszą być lokalne (lub względne) wobec samego pliku.
• Obsługiwane są geometrie punktów, linii i wielokątów.
• Wszystkie atrybuty danych są uznawane za ciągi znaków.

Te funkcje KML nie są obsługiwane:

• Ikony lub <styleUrl> zdefiniowane poza plikiem.
• Linki sieciowe, takie jak <NetworkLink>
• warstwy nad powierzchnią, np. <GroundOverlay>
• geometrie 3D lub wszelkie tagi związane z wysokością, np. <altitudeMode>;
• Specyfikacje aparatu, np. <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 (dobrze znany tekst)
• address, city, state, zip
• address
• Jedna kolumna zawierająca wszystkie dane adresowe, takie jak 1600 Amphitheatre Parkway Mountain View, CA 94043

Na przykład plik zawiera kolumny o nazwach x, y i wkt. x i y mają wyższy priorytet określony na podstawie kolejności obsługiwane nazwy kolumn z powyższej listy oraz 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 nie może mieć nazwy xy, który zawiera dane współrzędnych x i Y. Współrzędne x i y muszą znajdować się w osobnych kolumn.
• W nazwach kolumn nie jest rozróżniana wielkość liter.
• Kolejność nazw kolumn nie ma znaczenia. Jeśli na przykład plik CSV zawiera lat i long, mogą występować w dowolnej kolejności.

Postępowanie w przypadku błędów przesyłania danych

Podczas przesyłania danych do zbioru danych może wystąpić jeden z typowych błędów opisanych w tym artykule: .

Błędy GeoJSON

Typowe błędy GeoJSON:

• Brak pola type lub type nie jest ciągiem. Przesłany plik Plik danych GeoJSON musi zawierać pole ciągu znaków o nazwie type jako część każdego Obiekt funkcji i definicja obiektów geometrycznych.

Błędy KML

Typowe błędy w plikach KML:

• Plik danych nie może zawierać żadnych nieobsługiwanych obiektów KML wymienionych powyżej. W przeciwnym razie import danych może się nie powieść.

Błędy pliku CSV

Typowe błędy w pliku CSV:

• W niektórych wierszach brakuje wartości kolumny geometrycznej. Wszystkie wiersze w pliku CSV muszą zawierać niepuste wartości w kolumnach geometrii. Kolumny geometryczne:
  • latitude, longitude
  • lat, long
  • x, y
  • wkt
  • address, city, state, zip
  • address
  • Jedna kolumna zawierająca wszystkie dane adresowe, takie jak 1600 Amphitheatre Parkway Mountain View, CA 94043
  Uwaga: ten błąd często jest opisywany jako komunikat w sekcji formularz „Nie można przekonwertować ” . do podwójnego lub „Nie można przeanalizować danych wejściowych do lokalizacji geograficznej.: Geografia brakuje wartości”.
• Jeśli x i y to kolumny geometrii, upewnij się, że jednostki są długości i szerokości geograficznej. Niektóre publiczne zbiory danych korzystają z różnych układów współrzędnych w nagłówkach x i y. Jeśli zostaną użyte nieprawidłowe jednostki, zbiór danych może zaimportować ale renderowane dane mogą pokazywać punkty zbioru danych w nieoczekiwanych lokalizacjach.

Tworzenie zbioru 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ć niepowtarzalna 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łniania zbioru danych jako Komputer – oznacza lokalny plik w systemie lub Zasobnik Google Cloud Storage.
   • W przypadku opcji Komputer kliknij Przeglądaj, a następnie wybierz plik wybierz plik.
   • W sekcji Zasobnik Google Cloud Storage kliknij Przeglądaj i wybierz zasobnik i plik z danymi.
7. Wybierz Format pliku.
8. Kliknij Dalej, aby sprawdzić ustawienia.

9. Kliknij Utwórz. Pojawi się strona Zbiory danych z nowymi danymi. w gromadzeniu danych. Powinna ona mieć stan Przetwarzanie.

   Jeśli dane zostały przesłane:

   • Stan zbioru danych to UKOŃCZONO.
   • Zbiór danych stanie się „aktywny” to wersja, której używa Twoja aplikacja.

   Jeśli podczas przesyłania wystąpi błąd:

   • Stan nowej wersji zbioru danych jest ustawiony na stan inny niż UKOŃCZONO.

Wyświetlanie lub modyfikowanie zbioru danych

Po utworzeniu zbioru danych możesz go wyświetlić lub zmodyfikować:

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. Kliknij kartę Podgląd, aby wyświetlić zbiór danych na mapie (zbiory danych z atrybutem tylko stan UKOŃCZONO lub ODWRÓĆ).
   3. Kliknij kartę Dane w tabeli, aby wyświetlić wszystkie atrybuty zbioru danych (zbiory danych). tylko ze stanem UKOŃCZONO lub ODWRÓĆ). Są to atrybutów, których można użyć do określenia stylu zbioru danych na mapie.
   4. Kliknij przycisk Pobierz, aby pobrać dane do pliku lokalnego.
   5. Kliknij przycisk Usuń, aby usunąć zbiór danych.

   6. Kliknij przycisk Importuj plik danych, aby przesłać nowe dane do zbioru danych.

      Przesłanie nowych danych do zbioru danych powoduje utworzenie nowej wersji zbioru danych. Jeśli nowe dane – przesłane filmy:

      • Stan nowej wersji zbioru danych zostanie ustawiony na UKOŃCZONO.
      • Nowa wersja stanie się „aktywna”. to wersja, której używa Twoja aplikacja.

      Jeśli podczas przesyłania wystąpi błąd:

      • Stan nowej wersji zbioru danych jest ustawiony na stan inny niż UKOŃCZONO. Jeśli na przykład występuje poprzednia „aktywna” , wersja stan zbioru danych jest ustawiony na REVERTED (ODWRÓCONY).
      • Poprzednio „aktywne” wersja zbioru danych pozostaje „aktywna” i jest wersję używaną przez aplikację.