Konfigurowanie pliku danych

Poniższe informacje pomogą Ci prawidłowo skonfigurować i uruchomić pliki danych.

Hosting pliku danych

System pozyskiwania treści Waze automatycznie pobiera dane z pliku danych. Aby mieć pewność, że Waze pobiera prawidłowy plik danych:

  • Udostępnij go: użyj standardowych protokołów sieciowych (HTTP, HTTPS, FTP lub SFTP) lub Google Cloud Storage (GCS).
  • Zabezpiecz swoje dane (opcjonalnie):
    • Możesz zabezpieczyć plik danych za pomocą nazwy użytkownika i hasła, używając uwierzytelniania BASIC przez HTTPS. Kombinację loginu i hasła podajesz w Centrum partnerów.
    • Obsługujemy też integracje interfejsu API, które korzystają z uwierzytelniania opartego na nagłówkach za pomocą nagłówka KeyID lub OCP_APIM_SUBSCRIPTION_KEY.
    • W przypadku plików GCS możesz ograniczyć dostęp do konta usługi, które Ci udostępnimy.
  • Zadbaj o dostępność: upewnij się, że hostowany plik jest dostępny na całym świecie.
    • Aby uniknąć przerw w pobieraniu danych, upewnij się, że zapora sieciowa nie blokuje dostępu na podstawie kraju, adresu IP ani regionu geograficznego. Te ograniczenia mogą uniemożliwić nam pobranie danych z pliku danych.
    • Do pobierania informacji o zamknięciach i incydentach używamy dynamicznego systemu. Oznacza to, że nie używamy statycznych adresów IP ani nie obsługujemy wstępnie autoryzowanych adresów URL, domen ani symboli wieloznacznych ani autoryzacji wpisów DNS.

Częstotliwość przesyłania pliku danych

System pozyskiwania treści pobiera dane co kilka minut. Jeśli masz specjalne wymagania dotyczące częstotliwości przesyłania pliku danych, dodaj notatkę z prośbą o to podczas przesyłania pliku danych lub skontaktuj się z zespołem Waze, abyśmy mogli dostosować okresy odpytywania do cyklu aktualizacji pliku danych.

Weryfikacja XML

Waze używa tego schematu XML do określania dopuszczalnej struktury pliku danych CIFS: https://www.gstatic.com/road-incidents/cifsv2.xsd.

W internecie znajdziesz wiele narzędzi, które pomogą Ci sprawdzić poprawność struktury plików danych XML. Obejmują one m.in.:

Krytyczne zmiany w pliku danych

Zanim wprowadzisz którąkolwiek z tych zmian, powiadom zespół Waze, wypełniając ten formularz i edytując prośbę w Portalu, aby wskazać zaktualizowany plik danych.

  • modyfikowanie, dodawanie lub usuwanie regionów lub krajów z pliku danych;
  • zaktualizować adres URL pliku danych lub dane logowania wymagane do uzyskania dostępu do informacji;
  • zmiana struktury pliku danych lub nazw tagów;

Specyfikacje pliku danych

Jeden plik danych może zawierać informacje o wielu zamknięciach i incydentach. Jeśli podajesz informacje o wielu wydarzeniach, każde zamknięcie lub incydent musi być opisane w osobnym elemencie i mieć unikalny identyfikator. Te sekcje powinny zawierać lokalną datę i godzinę. W specyfikacji CIFS znajdziesz wszystkie dostępne tagi, które pozwolą Ci opisać incydenty i zamknięcia.