Facility feed

message FacilityFeed {
  repeated Facility data = 1;
}

// Info about a healthcare facility on the partner's platform. It could be a
// location/clinic that one or multiple practitioners work at. It could also be
// a bookable facility, like a test center.
// A FacilityFeed should be a list of this message.
message Facility {
  // An opaque string generated by the partner that identifies a facility.
  // Must be unique across all facilities.
  // Strongly recommended to only include URL-safe characters. (required)
  string facility_id = 1;

  // The name, telephone, url and geo are used to support matching partner
  // inventory with merchants/locations already present on Google Maps. This
  // information will not be displayed.
  //
  // The name of the facility. (required)
  string name = 2;

  // The contact telephone number of the facility including its country and area
  // codes, e.g. +14567891234. Highly recommended. (optional)
  string telephone = 3;

  // The url of the facility's public website. Highly recommended. (optional)
  string url = 4;

  // The Geo info of the facility, including latitude, longitude, and address.
  // (required)
  GeoCoordinates geo = 6;

  // An action URL with associated language, list of countries restricted to,
  // type, and optional platform that indicates which platform this action
  // should be performed on. This action link is specifically for the merchant,
  // please use the ActionLink in the appointment type feed to link to a
  // specific appointment type. (required if the booking link needs to be shown
  // in facility's profile in Google Search)
  repeated ActionLink action_link = 10;

  // The ID of the health system that the facility belongs to. (required)
  string health_system_id = 11;

  // ...
}

// The Geo data of a location, including latitude, longitude, and address.
message GeoCoordinates {
  // Optional.
  google.type.LatLng lat_lng = 1;

  // Address for a location, could either be structured or unstructured.
  // (required)
  oneof address {
    // Postal address of the location, preferred.
    PostalAddress postal_address = 2;

    // An unstructured address could also be provided as a fallback.
    // E.g. "1600 amphitheatre parkway mountain view, ca 94043"
    string unstructured_address = 3;
  }
}

// The postal address for a merchant.
message PostalAddress {
  // The country, e.g. "US". (required)
  string country = 1;

  // The locality/city, e.g. "Mountain View". (required)
  string locality = 2;

  // The region/state/province, e.g. "CA". This field is only required in
  // countries where region is commonly a part of the address. (optional)
  string region = 3;

  // The postal code, e.g. "94043". (required)
  string postal_code = 4;

  // The street address, e.g. "1600 Amphitheatre Pkwy". (required)
  string street_address = 5;
}

// An action URL with associated language, list of countries restricted to, and
// optional platform that indicates which platform this action should be
// performed on.
message ActionLink {
  // The entry point URL for this action link. (required)
  string url = 1;

  // The BCP-47 language tag identifying the language in which the content
  // from this URI is available. (optional)
  string language = 2;

  // An unordered list of ISO 3166-1 alpha-2 country codes. Leave empty for
  // unrestricted visibility. (optional)
  repeated string restricted_country = 3;

  // ...
}