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 co jakiś czas. Aby mieć pewność, że Waze pobierze prawidłowy plik danych:

  • Udostępnij go: użyj standardowych protokołów sieciowych (HTTP, HTTPS, FTP lub SFTP) albo Google Cloud Storage (GCS).
  • Zabezpiecz dane (opcjonalnie):
    • Możesz zabezpieczyć plik danych za pomocą nazwy użytkownika i hasła, używając podstawowego uwierzytelniania HTTP. Kombinację loginu i hasła podajesz w Centrum partnera.
    • Dodatkowo obsługujemy integracje z interfejsem API, które wykorzystują uwierzytelnianie oparte 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 nie blokuje dostępu na podstawie kraju, adresu IP lub 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, 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 tą prośbą podczas przesyłania pliku danych lub skontaktuj się z zespołem Waze, abyśmy mogli dostosować nasze okresy sondowania do cyklu aktualizacji pliku danych.

Walidacja XML

Waze używa tego schematu XML do określania akceptowalnej struktury pliku danych CIFS (Closure and Incidents Feed Specifications): https://www.gstatic.com/road-incidents/cifsv2.xsd.

W internecie jest dostępnych wiele narzędzi, które mogą pomóc w sprawdzeniu struktury plików danych XML. Oto niektóre z nich:

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.
  • Aktualizowanie adresu URL pliku danych lub danych logowania wymaganych do uzyskania dostępu do informacji.
  • Zmienianie 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 zdarzeniach, każde zamknięcie lub incydent musi być opisane w osobnym elemencie i mieć unikalny identyfikator. Te sekcje powinny używać lokalnej daty i godziny. Specyfikacja CIFS zawiera szczegółowe informacje o wszystkich tagach, których można użyć do opisania incydentów i zamknięć.