피드 설정

다음 정보는 피드를 올바르게 설정하고 실행하는 데 도움이 됩니다.

피드 파일 호스팅

Waze 콘텐츠 수집 시스템은 피드 데이터를 주기적으로 자동으로 가져옵니다. Waze에서 올바른 피드 파일을 가져오도록 하려면 다음을 따르세요.

  • 액세스 가능하게 만들기: 표준 네트워크 프로토콜 (HTTP, HTTPS, FTP 또는 SFTP) 또는 Google Cloud Storage (GCS)를 사용합니다.
  • 데이터 보호 (선택사항):
    • HTTPS를 통한 기본 인증을 사용하여 사용자 이름과 비밀번호로 피드를 보호할 수 있습니다. 파트너 허브를 통해 로그인 및 비밀번호 조합을 제공합니다.
    • 또한 KeyID 또는 Ocp-Apim-Subscription-Key 헤더를 통해 헤더 기반 인증을 사용하는 API 통합을 지원합니다.
    • GCS 파일의 경우 Google에서 제공하는 서비스 계정에 대한 액세스를 제한할 수 있습니다.
  • 접근성 보장: 호스팅된 파일에 전 세계에서 액세스할 수 있는지 확인합니다.
    • 데이터 가져오기가 중단되지 않도록 방화벽에서 국가, IP 주소 또는 지리적 위치를 기준으로 액세스를 차단하지 않도록 하세요. 이러한 제한사항으로 인해 Google에서 피드 데이터를 가져오지 못할 수 있습니다.
    • Google에서는 폐쇄 및 사고 정보를 가져오는 데 동적 시스템을 사용합니다. 즉, 고정 IP를 사용하지 않으며 사전 승인된 URL/도메인/와일드카드 또는 DNS 항목 승인도 지원하지 않습니다.

피드 빈도

콘텐츠 수집 시스템은 몇 분마다 데이터를 가져옵니다. 피드 빈도와 관련하여 특별한 요구사항이 있는 경우 피드를 제출할 때 이 요청을 나타내는 메모를 추가하거나 Waze팀에 문의하여 피드 업데이트 주기를 반영하도록 폴링 기간을 조정할 수 있도록 하세요.

XML 유효성 검사

Waze는 다음 XML 스키마를 사용하여 폐쇄 및 사고 피드 사양 (CIFS) 피드의 허용 가능한 구조를 정의합니다. https://www.gstatic.com/road-incidents/cifsv2.xsd.

인터넷에는 XML 피드의 구조를 검증하는 데 도움이 되는 여러 도구가 있습니다. 이러한 도구에는 다음이 포함되지만 이에 국한되지는 않습니다.

중요한 피드 변경사항

다음 변경사항을 적용하기 전에 이 양식 을 작성하고 포털에서 요청을 수정하여 업데이트된 피드를 식별하여 Waze팀에 알리세요.

  • 피드에서 지역 또는 국가를 수정, 추가 또는 삭제합니다.
  • 피드 URL 또는 정보에 액세스하는 데 필요한 사용자 인증 정보를 업데이트합니다.
  • 피드 구조 또는 태그 이름을 변경합니다.

피드 사양

단일 피드 파일은 여러 폐쇄 및 사고에 관한 정보를 제공할 수 있습니다. 여러 이벤트에 관한 정보를 제공하는 경우 각 폐쇄 또는 사고는 별도의 요소에 자세히 설명되어야 하며 고유한 ID가 있어야 합니다. 이러한 섹션에서는 현지 시간과 날짜를 사용해야 합니다. CIFS 사양 에는 사고 및 폐쇄를 설명하는 데 사용할 수 있는 모든 태그가 자세히 설명되어 있습니다.