1// Copyright (C) 2017 The Libphonenumber Authors. 2// 3// Licensed under the Apache License, Version 2.0 (the "License"); 4// you may not use this file except in compliance with the License. 5// You may obtain a copy of the License at 6// 7// http://www.apache.org/licenses/LICENSE-2.0 8// 9// Unless required by applicable law or agreed to in writing, software 10// distributed under the License is distributed on an "AS IS" BASIS, 11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12// See the License for the specific language governing permissions and 13// limitations under the License. 14 15syntax = "proto3"; 16 17package i18n.phonenumbers.metadata; 18 19option java_package = "com.google.i18n.phonenumbers.metadata.proto"; 20 21// The possible provenance which can be assigned to a range. 22// This enum is NOT stable and must only be stored in text based protocol 23// buffers. 24enum Provenance { 25 // Having a distinct default/unknown enum with a zero value is a proto3 thing. 26 // No data should actually ever have this value. 27 UNKNOWN = 0; 28 29 // Indicates that the ranges were defined in an official ITU document. The 30 // comment associated with this range should contain a link to the document. 31 // This is the most trusted for of evidence and will usually replace any 32 // previous "lower" provenance (though this is not always true for some 33 // countries). 34 ITU = 10; 35 36 // Indicates that the ranges were defined in an official IR21 document. The 37 // comment associated with this range should contain a link to the document. 38 // This is the most trusted for of evidence and will usually replace any 39 // previous "lower" provenance (though this is not always true for some 40 // countries). 41 IR21 = 20; 42 43 // Indicates that evidence for a range was found in a website belonging to 44 // an official, government endorsed entity (e.g. national telecoms operator), 45 // but not part of either an official ITU or IR21 document. 46 // The comment associated with this range should contain a URL to the 47 // appropriate page where the evidence was found. 48 GOVERNMENT = 30; 49 50 // Indicates that evidence for a range was found in a website belonging to a 51 // telecoms operators (mobile carrier, MVNO etc...). The comment associated 52 // with this range should contain a URL to the appropriate page where the 53 // evidence was found. 54 TELECOMS = 40; 55 56 // Indicates that evidence for a range was found in an unofficial website 57 // (e.g Facebook or a general company home page). The comment associated 58 // with this range should contain a URL to the appropriate page where the 59 // evidence was found. 60 WEB = 50; 61 62 // Used to indicate special situations in which a number is accepted as 63 // valid, despite no citeable evidence. When this provenance the coment text 64 // should indicate some bug report or internal reasoning as to why this range 65 // should be accepted. This provenance should be used only in exceptional 66 // circumstances and the comment may be scrubbed from externally published 67 // versions of the range data. 68 INTERNAL = 100; 69} 70